home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / programs / jetbbs10.zip / JETBBS.DAT / zoo / manual.doc < prev    next >
Text File  |  1993-03-17  |  124KB  |  3,099 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                 JetBBS Version 1.0
  12.  
  13.                              System Operator's Manual
  14.  
  15.                By Troy Beckstrom, Jason Haskins, and Dan Sanderson
  16.              Copyright (c) 1993 Troy Beckstrom. All Rights Reserved.
  17.  
  18.  
  19.  
  20.  
  21.  
  22.               %%%%%%%              %%%%%%%%%   %%%%%%%%%%      %%%%%  %
  23.                 %%%            %    %%%%  %%%    %%%%  %%%    %%%  %%%%
  24.                %%%            %%    %%%   %%%    %%%   %%%   %%%    %%%
  25.                %%%           %%%    %%%   %%%    %%%   %%%   %%%     %
  26.                %%%    %%%% %%%%%%   %%%  %%%     %%%  %%%    %%%%    %
  27.               %%%    % %%%  %%%    %%%  %%%     %%%  %%%      %%%%
  28.               %%%   %% %%%  %%%    %%%%%%       %%%%%%         %%%%
  29.               %%%  %%  %%   %%%    %%%  %%%     %%%  %%%        %%%%
  30.               %%%  %% %%%  %%%     %%%   %%%    %%%   %%%        %%%%
  31.              %%%  %%%%%    %%%    %%%    %%%   %%%    %%%  %      %%%
  32.          %%  %%%  %%%      %%% ___%%%    %%%   %%%    %%%  %      %%%
  33.         %%%  %%   %%%   %  %% /\  \%%   %%%%   %%%   %%%%  %%     %%%
  34.         %%  %%%   %%%  %  %%%/  \  \   %%%%   %%%   %%%%  %%%%   %%%
  35.          %%%%      %%%%    %/    \  \%%%%    %%%%%%%%%    %   %%%%%
  36.                            /\    /  /
  37.                           /  \  /  /
  38.                          /    \/  /
  39.                          \    /\  \
  40.                           \  /  \  \
  41.                            \/    \  \
  42.                             \    /  /
  43.                              \  /  /
  44.                       ___     \/  /     ___
  45.                      /\  \             /\  \
  46.                     /  \  \           /  \  \
  47.                    /    \  \         /    \  \      ___
  48.                    \    /  /        /\    /  /     /\  \
  49.                     \  /  /        /  \  /  /     /  \  \
  50.                      \/  /        /    \/  /     /    \  \
  51.                                   \    /  /      \    /  /
  52.                                    \  /  /        \  /  /
  53.                                     \/  /          \/  /
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                 Table of Contents
  60.  
  61.         Chapter 1 - Introduction.....................................4
  62.            System Requirements.......................................4
  63.            How To Contact Me.........................................5
  64.         Chapter 2 - Installation.....................................6
  65.         Chapter 3 - Customizing Text Files...........................7
  66.         Chapter 4 - Configuration....................................8
  67.            BBS.INI Configuration File................................8
  68.            Introduction to MNU Files.................................9
  69.         Chapter 5 - Advanced Features...............................11
  70.            Door Programs............................................11
  71.            Daily Events.............................................12
  72.            Multi-Line...............................................12
  73.            Windows 3.x..............................................13
  74.            Running a Pay System.....................................14
  75.         Chapter 6 - Utilities.......................................15
  76.            IMPORT Utility...........................................15
  77.            MSGFIX Utility...........................................15
  78.         Chapter 7 - Fixing Modem Problems...........................17
  79.            Common Problems and Suggested Solutions..................17
  80.            Modem Init Parameters....................................18
  81.         Chapter 8 - Using the BBS...................................20
  82.            Using the Message Base...................................20
  83.            Sub-Boards...............................................22
  84.            E-Mail...................................................22
  85.            Auto-Message, Board News, and Logon Messages.............22
  86.            Borderlines..............................................23
  87.            File Transfers...........................................23
  88.            BBS Phone List...........................................23
  89.            Userlog Menu.............................................23
  90.            Message Base and Userlog Scrolling.......................24
  91.            Access Levels............................................25
  92.            Sysop Function Keys......................................25
  93.         Chapter 9 - MNU Tutorial....................................27
  94.            MNU File "[menu]" Block..................................27
  95.            MNU File "[do]" Block....................................29
  96.         Chapter 10 - MNU %variable% Replacement Keywords............30
  97.         Chapter 11 - MNU Command Reference..........................32
  98.            Auto-Message.............................................32
  99.            Bank.....................................................32
  100.            Border...................................................33
  101.            Door.....................................................34
  102.            Goto.....................................................35
  103.            Logoff...................................................36
  104.            Mail.....................................................37
  105.            Message Base.............................................37
  106.            Miscellaneous............................................38
  107.            Multi-Line...............................................39
  108.            Phone List...............................................40
  109.            Print....................................................40
  110.            Sub-Boards...............................................40
  111.            Sysop....................................................41
  112.            Transfer.................................................43
  113.            Userlog..................................................44
  114.            Voting Poll..............................................45
  115.  
  116.                                       - 2 -
  117.  
  118.  
  119.  
  120.         Chapter 12 - Software License...............................46
  121.         Chapter 13 - Wish List for the Next Version.................47
  122.         Chapter 14 - Registration Form..............................48
  123.         Index.......................................................49
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.                                       - 3 -
  178.  
  179.  
  180.  
  181.                              Chapter 1 - Introduction
  182.  
  183.         JetBBS is a fully featured, yet easy to use shareware bulletin
  184.         board system.  Its strong points include:
  185.  
  186.             - Highly configurable.  Like a BBS construction kit that is
  187.                 already put together for you.  You can change almost
  188.                 anything to the way you want it.
  189.  
  190.             - Quick to install and easy to run.  JetBBS is designed to be
  191.                 able to run on its own without requiring sysop attention.
  192.  
  193.             - Multi-line capability.  Even if you only have one line, you
  194.                 can use this feature to log on locally while the BBS
  195.                 continues to take calls.
  196.  
  197.             - A conversion utility that can import the message base from
  198.                 almost any other BBS software.
  199.  
  200.             - Sub-Boards, so users can run their own mini-BBSes.
  201.  
  202.             - File transfers.
  203.  
  204.             - Support for three door protocols: DORINFO1.DEF,
  205.                 CALLINFO.BBS, and CHAIN.TXT.
  206.  
  207.             - Optional credit system with eight built in casino games.
  208.  
  209.             - Voting polls.
  210.  
  211.         SYSTEM REQUIREMENTS
  212.  
  213.             An IBM compatible computer
  214.  
  215.             A hard drive or at least one 1.2meg or 1.44meg floppy
  216.                disk drive
  217.  
  218.             At least 512k of RAM, with at least 335k available
  219.  
  220.             A modem
  221.  
  222.         You'll need to be running MS-DOS, or an operating system that can
  223.         emulate DOS, such as OS/2.  To run multiple lines, or to log on
  224.         locally while the BBS is running, you need a multitasking
  225.         operating system.  JetBBS has been tested thoroughly on Windows
  226.         3.1, and a JETBBS.PIF file is included for that purpose.  It
  227.         should work on Windows 3.0, DESQview, and OS/2 2.x, though I
  228.         haven't been able to test it on them.
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.                                       - 4 -
  239.  
  240.  
  241.  
  242.         HOW TO CONTACT ME
  243.  
  244.         I will be happy to answer your questions and help fix any problems
  245.         you are having.  I would also like to hear your suggestions for
  246.         the next version.  Please include your BBS's name and phone number
  247.         if you have one.  I can be reached by e-mail at:
  248.  
  249.             tbeckstr@u.washington.edu
  250.  
  251.             account #2 at Dimension Nine BBS, (206)522-3980
  252.  
  253.             tbeckstr at ProStar Plus, (206)941-0317 or (206)441-8752
  254.             (Press [A] at the top menu for National Dial-Up Information)
  255.  
  256.         Or by paper mail:
  257.  
  258.             Troy Beckstrom
  259.             PO Box 95724-J
  260.             Seattle, WA 98145-2724
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.                                       - 5 -
  301.  
  302.  
  303.  
  304.                              Chapter 2 - Installation
  305.  
  306.         To install JetBBS, you need to have the files JETSETUP.EXE and
  307.         JETBBS.DAT.  If you plan on running JetBBS on a floppy drive,
  308.         place these three files on the disk you want to use.  To install
  309.         on a hard drive, you don't have to move the files, they will be
  310.         copied to the directory you specify.  Type "JETSETUP" to begin the
  311.         installation program.
  312.  
  313.         After you have completed the setup process, you need to create an
  314.         account for yourself on the BBS.  You should be the first person
  315.         to log on after running the setup program, as the first account
  316.         will already be set at a Sysop level and feedback will be directed
  317.         there.  To create an account for yourself, run "JETBBS LOCAL" and
  318.         log in as "NEW".  After entering all the pertinent information,
  319.         you will be placed at the main menu.  From there, you need to
  320.         configure the board to suit your needs and tastes.
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.                                       - 6 -
  361.  
  362.  
  363.  
  364.                         Chapter 3 - Customizing Text Files
  365.  
  366.         This section will explain what help files are and guide you
  367.         through the process of customizing them to modify the physical
  368.         appearance of your BBS.  Help files usually contain a list of
  369.         options that a user may select from at a menu.  Besides editing
  370.         the help files, you will also need to edit and personalize the
  371.         text files that will be displayed upon logon and logoff as well as
  372.         the new user information file that will be displayed to new users
  373.         when they type "NEW" upon connecting with your board.  You may
  374.         either use the editor included with the BBS program, or any other
  375.         text editor you prefer.  The text and help files are contained in
  376.         \TEXT of the BBS directory.  The following are the text and help
  377.         files that you may edit.  NEWUSER.TXT, LOGON.TXT, and LOGOFF.TXT
  378.         should be edited, but all others are optional.
  379.  
  380.         \BBS\TEXT\NEWUSER.TXT (Text file displayed to new users)
  381.         \BBS\TEXT\LOGON.TXT   (Logon message displayed upon connect)
  382.         \BBS\TEXT\LOGOFF.TXT  (Logoff message displayed when logging off)
  383.         \BBS\TEXT\MAIN.HLP    (Main Menu help file)
  384.         \BBS\TEXT\MSG.HLP     (Message Base help file)
  385.         \BBS\TEXT\SUB.HLP     (Sub-Board help file)
  386.         \BBS\TEXT\BANK.HLP    (Bank/Casino help file)
  387.         \BBS\TEXT\POLL.HLP    (Voting Poll Help file)
  388.         \BBS\TEXT\USERLOG.HLP (Userlog help file)
  389.  
  390.         If you choose to use the editor included with the BBS, press [*]
  391.         to go to the Sysop menu, and then [+] to receive a menu of edit
  392.         options.  Press [T] to edit the help files.  All files that are
  393.         displayed to users will be included in the listing of available
  394.         choices.  You might want to go into each one and change "JetBBS"
  395.         your BBS's name to make things more personalized.  You may alter
  396.         the physical appearance of any of the ".HLP" or ".TXT" files in
  397.         any way you wish.  It will have no repercussions on what commands
  398.         you may access from that menu.
  399.  
  400.         You should be especially sure to edit NEWUSER.TXT which is
  401.         displayed to a new user after they log on and type "NEW" as well
  402.         as the LOGON.TXT and LOGOFF.TXT which are displayed to the users
  403.         upon logging on and off your board.  The NEWUSER.TXT should
  404.         contain information about what you expect out of the users, and
  405.         what your policies and requirements are on the BBS.  While in the
  406.         editor, you may use escape at any time to return to a listing of
  407.         files you may edit, or to the BBS.
  408.  
  409.         You can also use the BBS's built in message editor to edit text
  410.         files.  Its advantage is that it can also be used from remote (if
  411.         RemoteSysopPassword has been set, more on this later), but since
  412.         it can't use direct screen writes, it's not as easy to use as the
  413.         non-modemable editors.  To use it, press [E] in the sysop menu and
  414.         give it a filename, such as "TEXT\NEWUSER.TXT".
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.                                       - 7 -
  422.  
  423.  
  424.  
  425.                             Chapter 4 - Configuration
  426.  
  427.         BBS.INI CONFIGURATION FILE
  428.  
  429.         The BBS.INI file contains many useful and easy to change
  430.         configuration options.  This is one of the first files you should
  431.         view and change to suit your needs after entering the BBS for the
  432.         first time.  There are complete descriptions under each command in
  433.         the BBS.INI file which list the possible configurations for each
  434.         setting; so modifying this file is extremely easy.  To aid you in
  435.         editing this file and determining which configurations you may
  436.         want to modify, we will include several examples and elaborate on
  437.         some of the available settings.  To view or edit the BBS.INI file,
  438.         enter the sysop menu, press [+] and then select [I] from the list
  439.         of options.
  440.  
  441.         The BBS.INI file is broken up into two parts.  All lines with a
  442.         semicolon (";") in front of them are comments inserted in the file
  443.         to aid you in the configuration of the file.  Everything else in
  444.         the file is an actual command.  If you wish to prevent a line in
  445.         the file from being read, you may place a semicolon before it, and
  446.         the line will ignored.  This may useful if you wish to disable a
  447.         command or interject a note somewhere in the file.
  448.  
  449.         There are several lines in the BBS.INI file which you may wish to
  450.         change.  Regardless of whether you are interested in changing any
  451.         of the things that we mention, you should at least browse through
  452.         the BBS.INI file to see all the options that are available.
  453.  
  454.         JetBBS can filter out the escape character, which is the first of
  455.         several characters in a series which produce cursor movements and
  456.         colors on the screen.  These are generally called ANSI characters.
  457.         Since JetBBS does not differentiate between callers whose term
  458.         programs support ANSI emulation or not, those who do not support
  459.         it would be flooded with ANSI character should any message contain
  460.         any.  The current setting in the INI file is to allow escape
  461.         characters. If you would like to disallow them, change
  462.         "AllowEscChar: 1" to "AllowEscChar: 0".
  463.  
  464.         Also included in JetBBS is the ability to limit the number of
  465.         calls per day allowed at each access level and the amount of time
  466.         allowed on-line at each access level per day.  These are
  467.         particularly useful if you are running a popular file board or pay
  468.         board and need to place restrictions on the amount of time or
  469.         number of calls a user has on-line each day.  However, if you are
  470.         running a message oriented board, you may not be as concerned
  471.         about how long a user is on-line, or how many calls he or she
  472.         makes to your board each day.  In this case you may wish to raise
  473.         the amount of time they have on-line as well as the number of
  474.         calls allowed per day to a non-restrictive amount or even abolish
  475.         all limitations.  The calls allowed per day at each access level
  476.         as well as the time limit allowed at each access level per day may
  477.         be modified in the BBS.INI file.  If you would like to disable
  478.         them, you may place a semicolon before each line which will turn
  479.         them off.  You may also disable time limits or calls per day for
  480.         specific access levels and leave them intact for others.
  481.  
  482.                                       - 8 -
  483.  
  484.  
  485.  
  486.  
  487.         The Sysop menu can be accessed by any level 8 or 9 user, however
  488.         JetBBS places a restriction on certain commands.  There are some
  489.         commands in the sysop menu marked by an "(*)" that can access the
  490.         file system directly, inside and outside of the BBS's directory.
  491.         They are: Shell to DOS, Enter DOS Command, View Text File, Edit
  492.         Text File, Edit Doors, and Edit Transfer Areas.  There are others
  493.         that could be quickly and widely destructive to the BBS's data
  494.         files.  To defend against remote access to these commands, there
  495.         is a "RemoteSysopPassword:" field in the BBS.INI file.  If the
  496.         password is left blank, as it is when the BBS is first set up, the
  497.         commands cannot be accessed from remote at all.  Once you set a
  498.         password, they can be used from remote by using the password.  In
  499.         addition to protecting data, the password is also required in the
  500.         Edit User and Delete User commands if the user being changed is
  501.         level 8 or 9, or if a level 8 or 9 account is to be created.
  502.  
  503.         The remote sysop password serves as an added barrier of security
  504.         beyond the level 9 access level required to access sysop commands.
  505.         For most people, there is no need to make the whole computer
  506.         potentially accessible through the modem.  You may want to have
  507.         level 9 co-sysops who have full sysop control over the BBS, but
  508.         not over the rest of your computer.
  509.  
  510.         The remote sysop password is not required for sysops logged in
  511.         locally because the user at the local console could press [ALT+X],
  512.         [CTRL+C], or [CTRL+BREAK] and instantly get a DOS prompt to do
  513.         whatever he wants.  Commands listed as access level -2 in the MNU
  514.         files can only be used by the local sysop regardless of the remote
  515.         sysop password.  Level -2 is mainly used for calling external
  516.         programs that could not be used over the modem anyway.
  517.  
  518.         INTRODUCTION TO MNU FILES
  519.  
  520.         This section will explain how to alter MNU files which are located
  521.         in \MNU of the BBS directory.  We will give an overview of MNU
  522.         files so that you can get a feel of just how configurable JetBBS
  523.         really is.  If you would like an in depth look at the MNU files,
  524.         you may refer to the reference section of this manual.
  525.  
  526.         The MNU files are divided into two sections; the "[do]" block and
  527.         the "[menu]" block.  The "[do]" block contains commands that are
  528.         executed when someone enters the menu.  The commands in the
  529.         "[menu]" block execute when you press the proper key or enter a
  530.         "/" command.  The syntax for commands placed in the "[menu]" block
  531.         of a MNU file is:
  532.  
  533.         <key or "/" entry>,<command and arguments>,<level>,<text to print
  534.         when key is pressed>;
  535.  
  536.         One feature you may be interested in changing is the volume of the
  537.         chat bell.  If the default chat bell is not loud enough, there is
  538.         an alternate chat routine that you may use.  To implement it, you
  539.         will need to load MAIN.MNU into a text editor.  You should either
  540.         use [+] in the sysop menu or DOS 5.0's "EDIT".
  541.  
  542.  
  543.                                       - 9 -
  544.  
  545.  
  546.  
  547.         c,      chat,                               1,  Chat;
  548.  
  549.         Change that line to:
  550.  
  551.         c,      chatloud,                           1,  Chat;
  552.  
  553.         Another menu you may wish to modify is FIRST.MNU.  After entering
  554.         their usernumber and password correctly, this is the menu that
  555.         users will automatically be sent to.  Any of the "print"
  556.         statements may be altered in any way you wish.  You may change the
  557.         order in which these commands are carried out, prevent 300 baud
  558.         callers from using your board, and even change the menu that they
  559.         are placed in to begin with.
  560.  
  561.         After a user goes through the process of logging on, he is
  562.         normally placed in the main menu.  This can be altered so that
  563.         users are placed into a different menu, such as the message base
  564.         menu.  This may be ideal if you are running a message base board.
  565.         To make this change, edit FIRST.MNU and change the line "GOTO
  566.         MAIN.MNU" to "GOTO MSG.MNU."
  567.  
  568.         In FIRST.MNU and several of the other MNU files, you will notice
  569.         %variable% keyword replacements.  When you place these "%"
  570.         variables in your MNU files, they instruct JetBBS to retrieve
  571.         information such as what access level a user has, what comport
  572.         they are calling on, what baud they are connected at, as well as
  573.         specific information about the user on-line.  There is a complete
  574.         listing of all %variable% replacements in the reference section of
  575.         this manual.
  576.  
  577.         STATS.MNU is displayed to users when they press [Y] in the userlog
  578.         to view general information about themselves.  You may alter what
  579.         will be displayed to them by editing the file and deciding what
  580.         %variable%s you would like them to see when they access this
  581.         command.
  582.  
  583.         For more on MNU files, please refer to Chapter 9.
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.                                       - 10 -
  605.  
  606.  
  607.  
  608.                           Chapter 5 - Advanced Features
  609.  
  610.         DOOR PROGRAMS
  611.  
  612.         JetBBS provides three door chain formats which allows it to use a
  613.         wide variety of door games you may choose to put on-line.  It
  614.         includes support for DORINFO1.DEF, CALLINFO.BBS, and CHAIN.TXT.
  615.         Please refer to the chart below, which lists which chain formats
  616.         are compatible with which BBS programs.  Door games often request
  617.         the name of a BBS program instead of the name of the chain file.
  618.  
  619.             Chain file     Other BBSes that use it
  620.             ----------     -----------------------
  621.             DORINFO1.DEF   RBBS, QBBS, FoReM, TPB, T.A.G.
  622.             CALLINFO.BBS   Wildcat!
  623.             CHAIN.TXT      WWIV, Telegard
  624.  
  625.         This section will explain how to set up a door program to run with
  626.         JetBBS.  Included in the sysop menu is a utility which allows you
  627.         to enter all the pertinent information such as the command line to
  628.         execute, the key the user presses, and what to put in the help
  629.         file.  After you give JetBBS the information, it will
  630.         automatically place it into the DOOR.MNU file as well as the help
  631.         file for you.  The program will then be ready to run.
  632.  
  633.         Before setting up a door game to run with JetBBS, you must first
  634.         unpack the door you wish to run.  It is best to unpack it into a
  635.         subdirectory within the BBS directory.  For example, you would
  636.         type "MKDIR \BBS\<dir>", where <dir> is the name of the directory
  637.         you wish to create.  After unpacking the game, you need to read
  638.         the documentation included with the game for instructions on how
  639.         to set up the game.
  640.  
  641.         Each door game will vary slightly.  Some require you to run an
  642.         installation program, and others will not.  You will need to
  643.         follow the instructions to create a batch file or edit an existing
  644.         one that was included in the door game's archive.  Some games
  645.         automatically produce a batch file in any directory you specify.
  646.         If this is the case, tell the program to produce a batch file in
  647.         the \BBS directory.  They may also ask which directory your BBS
  648.         produces door files in.  Instruct them to look in \BBS.  The batch
  649.         file will need to "cd" to the proper directory, execute the door
  650.         along with any additional parameters, and "cd" back afterward.
  651.         Make sure you create the batch file in the \BBS directory.  See
  652.         the registration form if you would like to buy a disk full of door
  653.         games, as well as batch files already set up to run them from
  654.         JetBBS.
  655.  
  656.         You will need the following information to give to the door
  657.         installer which may be accessed by pressing [6] in the sysop menu.
  658.  
  659.             - The key you would like users to press to access the game
  660.             - What you want the BBS to print when they press that key
  661.             - Description of the game, or the line you would like to
  662.                 appear in the help file
  663.  
  664.  
  665.                                       - 11 -
  666.  
  667.  
  668.  
  669.             - The DOS command to execute the game (This should be the name
  670.                 of the batch file)
  671.             - The access level required to play the game
  672.  
  673.         For additional information on setting up door programs, refer to
  674.         the "door" section in Chapter 10.
  675.  
  676.         DAILY EVENTS
  677.  
  678.         Some door games require an event or maintenance program to be run
  679.         each day to update statistics and reset the player files in the
  680.         game.  If any games you have on-line require an event file to be
  681.         run at midnight each day, then you need to create a batch file to
  682.         run them.  The first thing to do is make a batch file to run the
  683.         door game event file.  To do this, have the batch file "cd" to the
  684.         directory, run the event file, and "cd" back.  You do not have to
  685.         worry about chain formats, as it will be run in local mode when
  686.         nobody is on-line.
  687.  
  688.         After you have created a batch file for each of the door game
  689.         event files, make another batch file called EVENT.BAT.  Tell this
  690.         file to run all the other event batch files using the syntax "call
  691.         DAILY.BAT" where "DAILY.BAT" is the name of the event batch file.
  692.         As you add more door games that require event files, you may
  693.         create batch files for them and add them to the list in EVENT.BAT.
  694.         You now need to edit your BBS.INI file and change the line
  695.         "MidnightEvent:" to "MidnightEvent: EVENT.BAT".  EVENT.BAT will be
  696.         run each day at midnight.  The following example is a standard
  697.         maintenance batch file as well as a model of what EVENT.BAT should
  698.         look like.
  699.  
  700.         Event batch file (EVENT.BAT):
  701.  
  702.             CALL DAILY1.BAT
  703.             CALL DAILY2.BAT
  704.             CALL DAILY3.BAT
  705.  
  706.         Door game daily maintenance batch file (DAILY1.BAT):
  707.  
  708.             CD GAMEDIR
  709.             DORMAINT.EXE
  710.             CD ..
  711.  
  712.         MULTI-LINE
  713.  
  714.         One of the impressive features that JetBBS boasts is the ability
  715.         to run a multi-line board.  By using a multitasking operating
  716.         system, you may run multiple JetBBS sessions at any given time.
  717.         JetBBS has been tested extensively under MS Windows 3.1.  It
  718.         should also have no problem running on Windows version 3.0 and
  719.         versions after 3.1.  Although I haven't been able to test with
  720.         them, it should run fine under OS/2 version 2.x or DESQview.
  721.  
  722.         Even if you do not plan to run a multi-line board, it is
  723.         convenient to be able to log on in local mode while another user
  724.         is on-line.  This way you will not have to take the BBS down every
  725.  
  726.                                       - 12 -
  727.  
  728.  
  729.  
  730.         time you want to log on from console.  Simply run a separate
  731.         session, which you should start by typing "JETBBS LOCAL" in the
  732.         \BBS directory.
  733.  
  734.         If you plan on running a multi-line system, you need to first edit
  735.         your AUTOEXEC.BAT file which is in your root directory and add the
  736.         line "SHARE" to the end if it isn't there already.  It will take
  737.         effect the next time you reboot.
  738.  
  739.         To take full advantage of the multi-line features, you need to
  740.         have a ramdrive.  To create a ramdrive, place the line:
  741.         "DEVICE=C:\DOS\RAMDRIVE.SYS 32 /E" in your CONFIG.SYS file which
  742.         is also located in your root directory.  If this is not the path
  743.         of your DOS directory, then substitute it in for "C:\DOS".  This
  744.         will instruct DOS to create a 32k ramdrive using extended memory
  745.         the next time you re-boot.  If you do not have more than 640k or
  746.         memory, then do not use the "/E" switch.  The ramdrive will appear
  747.         as the next unused drive letter, which is usually D: on most
  748.         systems with one unpartitioned hard drive.
  749.  
  750.         After creating a ramdrive, edit BBS.INI and locate the line
  751.         "RamDriveDir:".  Change it to "RamDriveDir: D:\" or whatever
  752.         letter it turns out to be on your system.
  753.  
  754.         After specifying RamDriveDir, you will be able to use multi-line
  755.         commands on JetBBS.  JetBBS will create a "lock" file on the
  756.         ramdrive that will prevent a user from logging in on more than one
  757.         line at the same time.  It will also keep track of their location
  758.         on the board.  Messages sent between two users while they are on-
  759.         line will be routed through the ramdrive.  The multi-line commands
  760.         are:
  761.  
  762.             /broadcast or /bc  Sends a message to all users currently on-
  763.                                  line.
  764.             /touch <user>      Sends a note to a specific user on-line.
  765.             /who               Displays all users that are currently on-
  766.                                  line, what comport they are connected on,
  767.                                  what speed they are calling at, and what
  768.                                  menu they are in on the BBS.
  769.  
  770.         When you create a ramdrive and set the BBS up to run as a multi-
  771.         line system, a "lock" file will be created on your ramdrive every
  772.         time a user logs on.  It will then be deleted when they log off.
  773.         The file will be saved in the format "LOCK#.TXT", where the "#" is
  774.         the caller's user number.  This will prevent a user from logging
  775.         in on more than one line at a time.  The lock file is also used by
  776.         the "/who" command to see what accounts are logged in.
  777.  
  778.         WINDOWS 3.X
  779.  
  780.         If you are multitasking under MS Windows 3.x, you will need to
  781.         create a PIF file for each additional session of JetBBS you wish
  782.         to run.  To create another PIF file, enter the PIF editor and open
  783.         the file JETBBS.PIF which is in the \BBS directory.  If you would
  784.         like to create a PIF for an additional modem, click on "Optional
  785.         Parameters" and enter "COM# baud", for example "COM2 2400".  Save
  786.  
  787.                                       - 13 -
  788.  
  789.  
  790.  
  791.         the file as some other filename, such as JETBBS2.PIF, and  create
  792.         a new icon in Windows to run it.  Two pre-made PIF files are
  793.         provided: JETBBS.PIF, which uses the default COM port and baud
  794.         speed, and JETLOCAL.PIF for you to log on locally.
  795.  
  796.         RUNNING A PAY SYSTEM
  797.  
  798.         JetBBS is designed to be configurable as a pay system by allowing
  799.         the sysop to sell usage time or credits for real money.  You don't
  800.         have to give out both, however, because you can set up commands in
  801.         the bank to exchange one for the other at some exchange rate.  The
  802.         exchange rate does not have to be the same both ways.  View or
  803.         edit BANK.MNU, which is located in \BBS\MNU, for more details.
  804.         (press [*], then [+], then [M], then move the highlight bar down
  805.         to BANK.MNU and press enter)
  806.  
  807.         To use time as the commodity on a pay board, first set the
  808.         MinutesPerDay lines in BBS.INI to the daily freebie handout that
  809.         will be given to non-paying users and to users who have run out of
  810.         paid time.  This should be relatively low; just enough to allow
  811.         them to get oriented with your board and see all the features
  812.         available.  For paying users, use the [A] Add Time command in the
  813.         sysop menu to give out usage time.  As long as their Time Left
  814.         stays above the MinutesPerDay setting, it will not be reset by
  815.         MinutesPerDay.  The MinutesPerDay setting only pulls people up
  816.         when they are below it; those above it are left alone.
  817.  
  818.         Some other settings in BBS.INI that might be of interest are
  819.         RefundPostingTime, which controls whether posting messages costs
  820.         time like everything else.  If posting time is refunded, it
  821.         encourages users to post messages without the worry of using up
  822.         their on-line time.  This is a good idea if you want to stimulate
  823.         long quality posts.  Users will be willing to spend more time
  824.         posting if they don't have to worry about paying for it in lost
  825.         time.  The default is that posts don't cost time.
  826.  
  827.         PayCreditsForPosting controls whether posts are rewarded 25
  828.         credits per line.  You might want to turn off PayCreditsForPosting
  829.         if you'll be selling credits, so that real money will be the only
  830.         way to get credits.  If you're worried that paying credits for
  831.         posts will encourage garbage posts, you don't need to be.  There
  832.         is an anti-instant-gratification feature built in that delays the
  833.         payment by about 2 days, by which time you will have seen the
  834.         posts and used "/sysop/u" to take away the delayed credits before
  835.         they arrive.  But, if you'd still rather not give credits for
  836.         posts, set PayCreditsForPosting to 0.
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.                                       - 14 -
  849.  
  850.  
  851.  
  852.                               Chapter 6 - Utilities
  853.  
  854.         IMPORT UTILITY
  855.  
  856.         The IMPORT utility converts messages from another BBS and brings
  857.         them into JetBBS's message base.  The messages to be converted
  858.         should be in one big text file captured from the other BBS.  If
  859.         the BBS you're converting from has a capture key for the sysop,
  860.         you can turn it on, read all the messages on the message base,
  861.         turn off the capture, and then use the capture file as the input
  862.         to IMPORT.  If the BBS doesn't have a sysop's capture key, have a
  863.         user call it up and use the capture buffer on his terminal
  864.         program.  While you're capturing the messages, make note of a text
  865.         keyword that is always present in the first line of every message
  866.         header.  You need to get the case exactly the same.  The longer
  867.         and more unique the keyword, the better.  Include the spaces if
  868.         you can.  For example, "Msg #: ", with the trailing space, is
  869.         good.  When you run the program, it will give you a list of good
  870.         keywords to use for some of the more popular BBSes.
  871.  
  872.         When you run IMPORT, it will ask you four questions: The path and
  873.         filename of the message text you just captured, the header
  874.         keyword, the room to add the messages to, and the location of your
  875.         message directory.  The imported messages will be posted in the
  876.         room like new messages.  It should be OK to dump all the messages
  877.         into one room, but in some cases the message accessing can get
  878.         slow when there are too many messages in a single room, especially
  879.         on a floppy drive or slow hard drive.  A disk cache such as
  880.         SMARTDRV should fix the problem.  Another solution is to break up
  881.         your capture files and put the messages in different rooms.
  882.  
  883.         If you started IMPORT from the same directory where you start
  884.         JETBBS, and you haven't changed the default MSG directory in
  885.         BBS.INI, and you're using a hard drive or a single floppy, type
  886.         "MSG" for the location of your message directory.  In other cases,
  887.         you should give the full path of your MSG directory.  On a two
  888.         floppy setup, it's probably "B:\MSG".
  889.  
  890.         While the program is running, it should print the first line of
  891.         all the headers that it is finding.  If it's not doing this, the
  892.         keyword is probably wrong.  You'll need to go into your MSG
  893.         directory, "cd" into the R# directory of the room you chose, and
  894.         delete the giant message that got the whole input file dumped into
  895.         it.  Then "cd" back up to where you were and try again with a
  896.         different keyword.
  897.  
  898.         MSGFIX UTILITY
  899.  
  900.         The MSGFIX utility can usually recover your message base if it is
  901.         lost.  Although the message base shouldn't ever get lost, we don't
  902.         live in a perfect world.  There are two parts of the message base
  903.         that must both be present for JetBBS to be able to read it.  There
  904.         are the actual message files themselves that contain the message
  905.         text, and the MSGLIST.DAT file that tells where each message is
  906.         stored, who posted it, how long it is, what number it is, and what
  907.         room its in.  If either or both are lost, the message base is
  908.  
  909.                                       - 15 -
  910.  
  911.  
  912.  
  913.         lost.  MSGFIX works in the case where the message text files still
  914.         exist, but MSGLIST.DAT is lost or corrupted, by rebuilding the
  915.         MSGLIST.DAT file.  It can't recover all the information that was
  916.         in MSGLIST.DAT, but it can recover enough to make the messages
  917.         readable again.  When you run the program it will tell you what
  918.         the differences are between a reconstructed MSGLIST.DAT and the
  919.         real thing.
  920.  
  921.         To run MSGFIX, first "cd" into your MSG directory.  Then, run
  922.         MSGFIX.  If it doesn't find it, try ..\MSGFIX or give the whole
  923.         pathname like C:\BBS\MSGFIX.  Read the warnings and then press
  924.         space to continue.  It will show you the rooms and messages its
  925.         finding, so you can check that it's finding what you expect it to
  926.         find, and then stop before it actually writes MSGLIST.DAT.  If it
  927.         didn't show any room numbers, or didn't show the right ones, press
  928.         [CTRL+C] to get out without writing MSGLIST.DAT, otherwise press a
  929.         key to go ahead.
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.                                       - 16 -
  971.  
  972.  
  973.  
  974.                         Chapter 7 - Fixing Modem Problems
  975.  
  976.         Before we begin, it is important for you to realize that modems
  977.         are not all identical and standard.  They all say they are 100%
  978.         Hayes Compatible, but that means about as much as a politician
  979.         saying he isn't going to raise taxes.  The fact is that the
  980.         majority of modems are used only for terminal programs to call out
  981.         to BBSes, so as long as the subset of modem functions that are
  982.         required for that is standard enough, most buyers are happy.  Even
  983.         if the modem occasionally gets confused in some circumstances, the
  984.         user is right there and can fix the problem.  Using a modem to run
  985.         a BBS exercises many more of the modem's functions that are part
  986.         of the Hayes standard, but not typically needed by terminal
  987.         programs, so it is more likely to find bugs in the modem.  What's
  988.         more, it has to work right every time and in every situation,
  989.         because the sysop is not present all the time to give it a kick if
  990.         something goes wrong.
  991.  
  992.         After much frustration with programming for modems, I have a great
  993.         distrust for them.  My attitude is to do things in more than one
  994.         way so if the modem fails to take one of the commands, the other
  995.         redundant method will probably work.  For example, I use DTR to
  996.         hang up, but then if the BBS sees that the modem hasn't hung up
  997.         after that, it uses the escape sequence (similar to +++, but
  998.         redefined as three happy faces so that innocent +'s don't
  999.         accidentally trip it).  As another example, the BBS uses the
  1000.         modem's auto-answer mode by default, but it can be configured to
  1001.         give the answer command itself when it sees "RING".
  1002.  
  1003.         The BBS will keep re-initializing the modem periodically while
  1004.         it's waiting for a call.  This insures that if the modem finds a
  1005.         way of getting screwed up, as it always seems to do, it will
  1006.         eventually get the message.  With external modems, it's possible
  1007.         for a power blip to make the modem lose its configuration without
  1008.         shutting down the computer.  Also, if the modem is confused or
  1009.         busy when the configuration is sent the first time, it'll
  1010.         eventually get it the second or third or fourth time.
  1011.  
  1012.         COMMON PROBLEMS AND SUGGESTED SOLUTIONS
  1013.  
  1014.         - BBS doesn't logoff when user drops carrier.
  1015.  
  1016.             The modem must set carrier detect to depend on reality, not
  1017.             always on.  The ModemInitStrings should have &C1 in them to
  1018.             make the modem tell the BBS whether carrier is detected.  Some
  1019.             older modems have to be configured by dip switches, so see
  1020.             your modem manual.  If you have an external modem, some modem
  1021.             cables do not have the carrier detect (CD) line.
  1022.  
  1023.         - Modem doesn't hang up at logoff unless user drops carrier.
  1024.  
  1025.             The modem is ignoring DTR.  The ModemInitStrings should have
  1026.             &D2 and S2=1 in them as two ways of configuring the modem to
  1027.             be able to hang up, but some modems have to be configured by
  1028.             dip switches.  Also, some modem cables do not carry the DTR
  1029.             line.
  1030.  
  1031.                                       - 17 -
  1032.  
  1033.  
  1034.  
  1035.         - BBS prints ERROR instead of OK after the init line with &D2 &C1
  1036.           on it.
  1037.  
  1038.             Unless it is having one of the previous two problems, don't
  1039.             worry about it.  If you are having either of the two problems,
  1040.             then the reason is that one of the configuration switches &D2
  1041.             or &C1 is being ignored.  See &D2 and &C1 in the list later in
  1042.             this chapter to see what they're supposed to do, then check
  1043.             your modem manual to figure out what you're supposed to do to
  1044.             get the same effect.  On some older modems, you have to use
  1045.             dip-switches to set the configuration.  Briefly, the &D2
  1046.             configures the modem to allow the BBS to tell it when to hang
  1047.             up.  The &C1 configures the modem to tell the BBS when carrier
  1048.             is lost.
  1049.  
  1050.         - Modem doesn't answer when phone rings, even though it's printing
  1051.           "RING".
  1052.  
  1053.             Try setting "AnswerOnRing:" in BBS.INI to 1, and changing S0=1
  1054.             to S0=0.
  1055.  
  1056.         - Modem connects but the BBS doesn't start.
  1057.  
  1058.             This could be a variety of problems, but something you can try
  1059.             is to change V1 to V0 in "ModemInitString3:" in BBS.INI, so
  1060.             the modem will give number codes.
  1061.  
  1062.         MODEM INIT PARAMETERS
  1063.  
  1064.         Z = Reset state.  This is to get the modem in the same state each
  1065.         time.
  1066.  
  1067.         Modems are often fussy about hanging up, so the BBS uses two
  1068.         methods with the hope that the modem will respond to at least one
  1069.         of them:
  1070.  
  1071.         &D2 = On DTR, hang up, goto command mode, auto-answer off.  This
  1072.         is tried first.  If you have an external modem, the cable must
  1073.         have the DTR line.  Modems default to ignore DTR, but most for
  1074.         most, &D2 makes them respond to it.
  1075.  
  1076.         S2 = Set escape character, must be set to 1 (happy face).  If DTR
  1077.         doesn't work, the three happy faces are printed.  S2=1 is
  1078.         necessary because the default is +++, which could be typed by the
  1079.         user.
  1080.  
  1081.         &C1 = Carrier detect line depends on presence of carrier.  If the
  1082.         BBS doesn't notice when users drop carrier without logging off,
  1083.         then your modem is keeping the CD (carrier detect) line on all the
  1084.         time.  &C1 for some modems will make the CD line depend on the
  1085.         presence of carrier, but others must have a dip switch changed.
  1086.         See your modem manual if the BBS isn't detecting drop of carrier.
  1087.  
  1088.         X1 = Don't act like an ancient 300 baud modem.  Without this, the
  1089.         modem will just print CONNECT no matter what speed the modem
  1090.  
  1091.                                       - 18 -
  1092.  
  1093.  
  1094.  
  1095.         connects at, and the BBS will have no way of knowing what speed to
  1096.         change to and will have to assume 300 baud because CONNECT without
  1097.         a speed means 300 baud.
  1098.  
  1099.         V1 = Word responses (recommended for speeds above 2400). This
  1100.         means that the modem prints, for example, "CONNECT 2400" instead
  1101.         of "10".  The BBS can understand the number codes too, but words
  1102.         are easier for the humans to see if it's working.  For modem
  1103.         speeds above 2400 baud, V1 is important because I'm not sure what
  1104.         the number codes are, but the BBS will respond to "CONNECT
  1105.         <baud>".
  1106.  
  1107.         Q0 = Print result responses.  Without this, the modem won't say
  1108.         what's happening, and the BBS would have no way of knowing what's
  1109.         going on.
  1110.  
  1111.         S0 = Auto-answer on or off.
  1112.  
  1113.         S7 = Time to wait for carrier on answer, in seconds.
  1114.  
  1115.         S10 = Time to wait before dropping line, in tenths of seconds.
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.                                       - 19 -
  1153.  
  1154.  
  1155.  
  1156.                             Chapter 8 - Using the BBS
  1157.  
  1158.         USING THE MESSAGE BASE
  1159.  
  1160.         [M] from the main prompt or "/msg" from any prompt gets you to the
  1161.         main message base.  The prompt displays the room number, room
  1162.         name, and the current message number range:
  1163.  
  1164.             01-Lobby [1-56] Msg:
  1165.  
  1166.         This example shows room 01, named "Lobby", has 56 messages in it,
  1167.         numbered 1-56.
  1168.  
  1169.             04-Restaraunt Reviews [33-272] Msg:
  1170.  
  1171.         This example shows room 04, names "Restaurant Reviews", has 239
  1172.         messages in it, numbered 33-272.  Messages 1-32 in this room were
  1173.         "scrolled", or deleted when the amount of space for messages ran
  1174.         out.  When allocated space runs out, the oldest messages are
  1175.         deleted to make room for new ones.
  1176.  
  1177.         [R] Read Messages lets you read messages in order starting from
  1178.         any available message in the message range (given in the message
  1179.         base prompt).  JetBBS will ask you for a starting message number,
  1180.         and will display the messages in that room in order.  If you have
  1181.         specified a pause between each message, at the end of each message
  1182.         there will be a prompt with the available message range:
  1183.  
  1184.             [1-56] ?=help, Read:
  1185.  
  1186.         From this prompt you can [Q] Quit reading messages, [E] Enter a
  1187.         message in the middle of reading (good for if you don't want to
  1188.         forget what you're going to say.  Note: The entered message will
  1189.         go at the end of the message list, as if you entered it from the
  1190.         message prompt), type a message number to jump to that message
  1191.         (and continue reading forward from there), or just press [ENTER]
  1192.         to go to the next message.  After the last message, the message
  1193.         base prompt will appear instead of the pause prompt.
  1194.  
  1195.         [N] Newscan is like [R] Read Messages except it will start with
  1196.         messages posted since your last call.  If you have specified to
  1197.         see the last old message on new, it will start one message before
  1198.         it.  If on your last call you terminated the session while keeping
  1199.         newscan pointers, [N] Newscan will start with the messages since
  1200.         the last time you terminated without keeping newscan pointers.  If
  1201.         you set your newscan pointers to something different with [V] Set
  1202.         newscan (see below), then it will start with whatever you set.
  1203.  
  1204.         While a message scrolls by on the screen (mostly applicable to
  1205.         remote calls; the local terminal might be too fast for these keys
  1206.         to be of any use), you can press [SPACE] to automatically jump to
  1207.         the next message (or quit if there are no more messages), [A]
  1208.         Abort to quit reading messages, or [P] Pause or [CTRL+S] to pause
  1209.         the display.
  1210.  
  1211.  
  1212.  
  1213.                                       - 20 -
  1214.  
  1215.  
  1216.  
  1217.         There is also a global newscan that allows you to page through all
  1218.         the new messages in every area in the message base.  Type [Z]
  1219.         Zipscan/read all new to use it, or type "/gl" or "/global".
  1220.  
  1221.         To enter a message in the current message area displayed by the
  1222.         prompt, press [E] Enter message.  The message editor will pop up:
  1223.  
  1224.             Enter message / 300 lines max / .?=help
  1225.  
  1226.         The cursor will be on the next line.  You can type your message.
  1227.         The words will word-wrap at the end of the line.  Once you are
  1228.         finished, you can type ".s" or "/s" on the beginning of a blank
  1229.         line to save the message and exit from the editor.  You can edit
  1230.         what you have with the other editor commands, which are listed
  1231.         when you type ".?".  If you reach the maximum number of lines, the
  1232.         message is automatically saved.
  1233.  
  1234.         Type [K] Known rooms to get a list of all the rooms you have
  1235.         access to.  (Rooms a user doesn't have access to will not show up
  1236.         in the list, and the user will not be able to move to them.)
  1237.  
  1238.         You can move around the message areas in the message base with [-]
  1239.         or [<] Previous room, [+] or [>] Next room, [J] Jump to room, [G]
  1240.         Goto new, or [U] Ungoto.  [-] or [<] Previous room will go one
  1241.         room number back if the room exists.  [+] or [>] will go one room
  1242.         number forward if the room exists.  [J] Jump to room will let you
  1243.         enter a room number to jump directly to.  If you are the sysop,
  1244.         you can jump to any room, otherwise you are limited to only the
  1245.         ones on the known rooms list.  [G] Goto new will go to the next
  1246.         room with new messages in it; if there are none left, it will go
  1247.         to the first room.  [U] Ungoto is like the Goto new messages
  1248.         command, but it goes in the other direction.
  1249.  
  1250.         It is possible for any user to delete his own messages.  Type [D]
  1251.         Delete message and it will prompt for a message number.  This
  1252.         command only lets the user delete messages that that specific user
  1253.         entered; it will not allow the user to delete a message written by
  1254.         another person.
  1255.  
  1256.         Note:  The sysop, co-sysops, sub-ops, or room-ops can delete other
  1257.         user's messages with the "/delete" command, or the [D] command in
  1258.         the sysop menu.  (The sysop and co-sysops can delete all messages,
  1259.         sub-ops can delete messages only on their sub-board, and room-ops
  1260.         can delete messages in their room.)
  1261.  
  1262.         [V] Set newscan will allow you to change the number of messages
  1263.         considered new by the commands that scan for new messages.  Note:
  1264.         The number that this command changes is the number of new messages
  1265.         for the entire board, including sub-boards, based on date.  This
  1266.         command is useful in case you only want to read some of the latest
  1267.         messages but a large number of messages are considered new (if you
  1268.         went on vacation, for example, and the new messages piled up since
  1269.         over a month ago and you don't want to read a month's worth of
  1270.         messages).
  1271.  
  1272.  
  1273.  
  1274.                                       - 21 -
  1275.  
  1276.  
  1277.  
  1278.         [Y] Post anonymous will let you post a message without your name
  1279.         or the date and time showing up in the message header.
  1280.  
  1281.         Note: Because the anonymous function can be abused, in the default
  1282.         MNU files, the anonymous posting function is set at level 2
  1283.         instead of the normal level 1.  This can be changed by the sysop
  1284.         by editing MSG.MNU.
  1285.  
  1286.         SUB-BOARDS
  1287.  
  1288.         To get to the sub-boards from either the message prompt or the
  1289.         main menu, press [S].  You will see a list of the sub-boards you
  1290.         have access to with their one-line advertisements.  If you do not
  1291.         have access to any sub-boards (or all the sub-boards are closed),
  1292.         you are told so and are returned to the message prompt.
  1293.         Otherwise, you'll see a welcome screen (if available--optional,
  1294.         sub-op's prerogative).
  1295.  
  1296.         It is important to note the sub-boards have a separate access
  1297.         system from the rest of the BBS (with the exception that the sysop
  1298.         of the BBS has complete power over everything).  It can have a
  1299.         sub-op, which has complete control over the sub (besides the
  1300.         sysop, of course), it can be made private with only select members
  1301.         of the userlog allowed, and it can have different access levels
  1302.         for each room (and room-ops) that deal with the sub-board's access
  1303.         userlog.
  1304.  
  1305.         Sub-boards act just like the main message base.  All the commands
  1306.         for the main message base apply.  The sub-board prompt is
  1307.         different; it doesn't have the room number.  (This is a good way
  1308.         to tell if you're in a sub-board or not.)
  1309.  
  1310.         E-MAIL
  1311.  
  1312.         From the main menu, [E] Send E-mail, or "/mail" from anywhere,
  1313.         will let you send electronic mail to another user.  Simply enter
  1314.         the name, number, or part of the name of the user you want to send
  1315.         it to, and enter the message.
  1316.  
  1317.         When you log on, if you have mail waiting, it is automatically
  1318.         displayed.  After each message, you will be given a chance to re-
  1319.         read it, delete the individual message, or send e-mail (to the
  1320.         person who sent it or to anyone else).  After you finish reading
  1321.         all of your mail, you are given the option to delete all of your
  1322.         waiting mail.  Mail that you don't delete will appear again on
  1323.         your next call.
  1324.  
  1325.         If you want to read waiting mail while on-line, type "/readmail"
  1326.         at a prompt.  In the default menus there is no one-key command for
  1327.         this, but you, the sysop, can edit an MNU file and add it to one
  1328.         of the menus.  You can use this command to review mail, or read
  1329.         new mail that just came in if it was a multi-line system and a
  1330.         user on another line just sent you mail.
  1331.  
  1332.         AUTO-MESSAGE, BOARD NEWS, AND LOGON MESSAGES
  1333.  
  1334.  
  1335.                                       - 22 -
  1336.  
  1337.  
  1338.  
  1339.         You can access the Auto-Message menu with [A] from the main menu
  1340.         or "/auto-msg" from any command prompt.  The Logon Messages, if
  1341.         they exist, are always displayed after someone logs on.  The
  1342.         Auto-Message and Board News are displayed only when the user
  1343.         hasn't seen them yet.  The Logon Messages and Board News are
  1344.         posted by the sysop only, and the Auto-Message can be posted by
  1345.         level 3 users and up.
  1346.  
  1347.         [N] Read the Board News displays the current Board News.  [R] Read
  1348.         the Auto-Message displays the current Auto-Message.  [P] Post the
  1349.         Auto-Message wipes out the old Auto-Message and lets you enter a
  1350.         new one (level 3 only).  [L] Edit Logon Messages lets you edit one
  1351.         of the three available Logon Messages to be displayed between the
  1352.         user stats and the Board News after the logon sequence.
  1353.  
  1354.         BORDERLINES
  1355.  
  1356.         Borderlines are one line messages that appear before every
  1357.         occurrence of the main menu prompt.  They can be read as a list or
  1358.         posted by anyone.  [B] or "/border" gets to the borderline menu.
  1359.         You can [R] Read the borderlines, [P] Post a borderline, [A] Post
  1360.         an anonymous borderline, or [S] See border authors.  There are 10
  1361.         borderlines, numbered 0 to 9.  You can read the list, post your
  1362.         own (wiping out the old one to put a new one in its place), or see
  1363.         the authors of the borderlines (who posted them).  Seeing the
  1364.         borderline authors takes a small number of credits to do; you can
  1365.         purchase a peek for 200 credits.  If you don't want people to see
  1366.         your name when they look at the authors, you can post one
  1367.         anonymously like you can a message.
  1368.  
  1369.         FILE TRANSFERS
  1370.  
  1371.         The main file transfer section is accessible from the main menu
  1372.         with [X] File Transfer Menu or "/xfer".  You will see a menu of
  1373.         file areas, plus an option to [S] Upload to Sysop (any user can
  1374.         upload a file to the sysop's private directory, where no one can
  1375.         download it until the sysop moves it to another file area).  The
  1376.         file areas themselves are customizable by the sysop.
  1377.  
  1378.         BBS PHONE LIST
  1379.  
  1380.         [P] Phone list of other BBSes or "/phone" gets you to a BBS
  1381.         phonebook.  This list of BBSes can be added to by anyone with [P]
  1382.         Post/add a BBS to the list, and can be read by anyone with [R]
  1383.         Read the BBS list.  This is a good way to promote other BBSes in
  1384.         the area, and can build a good small database for other BBSes.
  1385.  
  1386.         USERLOG MENU
  1387.  
  1388.         To get to the userlog menu, type [U] from the main menu or
  1389.         "/userlog".  From the userlog menu, you can examine or change your
  1390.         own stats and password, change your BBS preferences, examine other
  1391.         accounts, see the caller log, examine and search the database of
  1392.         users, or see an automatically generated call-times chart.
  1393.  
  1394.  
  1395.  
  1396.                                       - 23 -
  1397.  
  1398.  
  1399.  
  1400.         [Y] Your user stats "/stats" displays what is currently on record
  1401.         as your age, access level, the number of credits you have, the
  1402.         number of times you called the BBS, the number of posts you've
  1403.         made with the total number of lines posted, the date and time of
  1404.         your last call, and how much time you spent on the current call
  1405.         and how much you have left.  You can modify this command by
  1406.         editing STATS.MNU.
  1407.  
  1408.         [I] Change your user info "/userinfo" lets you change your name,
  1409.         password, computer type, city and state, phone number and first
  1410.         name, age, and preferences.  These questions are the ones asked of
  1411.         newusers.
  1412.  
  1413.         [P] Change your password "/password" lets you change your password
  1414.         only.
  1415.  
  1416.         [B] Change your BBS preferences "/pref" lets you change your BBS
  1417.         preferences only.
  1418.  
  1419.         [A] List the entire userlog "/allusers" shows a summary list of
  1420.         every account on the BBS.
  1421.  
  1422.         [C] Calling times chart "/calltimes" displays a chart of the
  1423.         number of calls during the periods in the day.  This is a good way
  1424.         to see when the least busy time of day is to call.
  1425.  
  1426.         [L] Caller Log "/callers" shows a list of a few recent callers
  1427.         with their names and the times they logged off.  The number of
  1428.         lines can be adjusted by editing the file SYS\CALLERS.TXT and
  1429.         deleting lines or adding extra blank lines.
  1430.  
  1431.         MESSAGE BASE AND USERLOG SCROLLING
  1432.  
  1433.         When a new message is posted and the message base has already
  1434.         expanded to its size limit, the oldest message or messages are
  1435.         deleted to make space for the new one.  The old messages can be
  1436.         anywhere on the main message base or in the Sub-Boards.  So,
  1437.         messages exist for a certain length of time and then scroll,
  1438.         regardless of where they are.  The number of messages in a room
  1439.         increases in the popular rooms and decreases in slower ones.
  1440.  
  1441.         The JetBBS userlog recycles ("scrolls") accounts in a way similar
  1442.         to how it scrolls messages.  When a new user logs on, it searches
  1443.         for the account that has been inactive for the longest time and
  1444.         re-uses it, with some exceptions depending on access level and
  1445.         number of calls.  The majority of accounts are new users who
  1446.         called once and never called back, and they scroll the fastest.
  1447.         Accounts with 2-9 calls take twice as long to scroll, and accounts
  1448.         with 10 or more calls take 4 times as long to scroll.  On top of
  1449.         that, an access level of 2 multiplies the time to scroll by 4
  1450.         again, so a level 2 user who has called more than 10 times will
  1451.         take 16 times as long to scroll as an account that was only used
  1452.         once and then abandoned.  Accounts with level 3 and above never
  1453.         scroll.  My experience has been that with 200 accounts, abandoned
  1454.         accounts with 1 call last about 1 1/2 months, 2-9 calls last 3
  1455.         months, and 10+ calls last 6 months.
  1456.  
  1457.                                       - 24 -
  1458.  
  1459.  
  1460.  
  1461.         ACCESS LEVELS
  1462.  
  1463.             Level 1 - New user, can't post auto-message, post 1 border per
  1464.                         day, no anonymous messages
  1465.             Level 2 - Scrolls 4 times slower than level 1
  1466.             Level 3 - Non-scrolling, a typical level for regular callers
  1467.             Level 4 - Can make voting polls
  1468.             Level 5 - Has /rename and /delete commands, typically used for
  1469.                         trusted users
  1470.             Level 8 - Semi-sysop, can do msg base stuff but not userlog
  1471.             Level 9 - Sysop
  1472.  
  1473.         SYSOP FUNCTION KEYS
  1474.  
  1475.         [F1] Help Screen - Brief version of this list.
  1476.  
  1477.         [F2] Chat - Go into chat mode.  You can press this anytime the BBS
  1478.         is waiting for the user to enter something.  To leave chat, press
  1479.         the [F2] key again.  As you leave, it will reprint the line that
  1480.         the user was on so he can be reminded of what he was supposed to
  1481.         enter and pick up where he left off.  If you use chat in the
  1482.         editor on a blank line, it may be a bit confusing when you leave
  1483.         chat.  Type ".l" to re-list the message so he can see what he was
  1484.         doing.
  1485.  
  1486.         [F3] Temp Sysop - Toggles temporary sysop access on and off.  At
  1487.         the end of the call, the level will go back to normal.
  1488.  
  1489.         [F4] Print Password - Print user's info, including password.  If
  1490.         you see someone logging on who has forgotten his password, and you
  1491.         want to give him a hint, you could have him enter his account
  1492.         number and then you can press [F4] to see his password.  The
  1493.         password and info are printed locally only.
  1494.  
  1495.         [F5] Forced Logoff - Prints the ForceLogoffPrint string from
  1496.         BBS.INI and then hangs up.  The default message printed is "Have a
  1497.         nice day :)".
  1498.  
  1499.         [F7] Edit This User - Edit the user who is currently on-line.
  1500.  
  1501.         [F9] Status Bar on/off - So you'll have more room on the screen.
  1502.  
  1503.         [F10] Capture on/off - Copy all text printed to the screen to
  1504.         CAPTURE.TXT.  If the file already exists, it is replaced by the
  1505.         new text.
  1506.  
  1507.         [SCROLL LOCK] Sysop Not Available - The chat call is disabled when
  1508.         scroll lock is turned
  1509.         on.
  1510.  
  1511.         [ALT+X] Exit - Works anytime the BBS is ready for input.  Logs off
  1512.         and hangs up if necessary.
  1513.  
  1514.  
  1515.  
  1516.  
  1517.                                       - 25 -
  1518.  
  1519.  
  1520.  
  1521.         [CTRL+C] or [CTRL+BREAK] Brute Force Exit - Works like [ALT+X] but
  1522.         doesn't hang up if on-line.  You could run a terminal program next
  1523.         and the user will still be connected.
  1524.  
  1525.         [RIGHT ARROW] Increase Credits by 100cr.
  1526.  
  1527.         [LEFT ARROW] Decrease Credits by 100cr.
  1528.  
  1529.         [UP ARROW] Increase Time Left by 10 minutes.
  1530.  
  1531.         [DOWN ARROW] Decrease Time Left by 10 minutes.
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.                                       - 26 -
  1579.  
  1580.  
  1581.  
  1582.                              Chapter 9 - MNU Tutorial
  1583.  
  1584.         MNU FILE "[MENU]" BLOCK
  1585.  
  1586.         This section will take an in-depth look at the BBS's menus.  They
  1587.         have the file extension MNU and are located in the \BBS\MNU
  1588.         directory.  We will also go step by step through the process of
  1589.         adding, modifying, or removing commands from menus.  The following
  1590.         is an example of some standard lines in an MNU file.  They were
  1591.         taken from the main menu (MAIN.MNU):
  1592.  
  1593.         [menu]
  1594.  
  1595.         ;key    command                          level  print
  1596.  
  1597.         u,      goto userlog.mnu,                   1,  Userlog;
  1598.         c,      chat,                               1,  Chat;
  1599.         o,      logoff,                             0,  Off/hang up;
  1600.         e,      sendmail,                           1,  Send e-mail;
  1601.         f,      feedback,                           0,  Feedback;
  1602.  
  1603.         As you can see, the "[menu]" portion of the menu consists of the
  1604.         "key" which is the letter or number that the user must press in
  1605.         order to execute the command; the "command" which tells JetBBS
  1606.         what to execute when the key is pressed; the level that the user
  1607.         must have in order to execute the command; and the message to
  1608.         display when the key is pressed.  Commas are used to separate each
  1609.         portion of the line, and a semicolon is the last character of the
  1610.         line to which signifies the end.
  1611.  
  1612.         The second way of accessing a command in JetBBS is to type "/"
  1613.         followed by a command as displayed in the following excerpt from
  1614.         GLOBAL.MNU.  GLOBAL.MNU is special because it contains commands
  1615.         that can be accessed ANYWHERE on the BBS simply by typing "/" and
  1616.         then the command.  For this reason, they are extremely useful
  1617.         commands.  After learning them, you don't have to pay attention to
  1618.         what menu you are in, and try to examine the help file to figure
  1619.         out how to get to where you want to go.  An example would be
  1620.         "/msg" which would take you directly to the message base.  The
  1621.         following are commands currently in your GLOBAL.MNU and do the
  1622.         exact same things that those you see above.  These, however, are
  1623.         ways of accessing the command with the "/" key from anywhere on
  1624.         the BBS.
  1625.  
  1626.         [menu]
  1627.  
  1628.         ;entry          command                          level  print
  1629.  
  1630.         userlog,        goto userlog.mnu,                   1,  ;
  1631.         chat,           chat,                               1,  ;
  1632.         off,            logoff,                             0,  ;
  1633.         mail,           sendmail,                           1,  ;
  1634.         feedback,       feedback,                           0,  ;
  1635.  
  1636.         You can see how useful it would be to be able to access these
  1637.         commands anywhere.  If you were reading messages in the message
  1638.  
  1639.                                       - 27 -
  1640.  
  1641.  
  1642.  
  1643.         base and wanted to go to the userlog to see how much time you had
  1644.         left on-line, you could either quit to the main menu, locate the
  1645.         key to hit to go to the userlog, and then hit it; or you could
  1646.         just type "/userlog" and be there in an instant.
  1647.  
  1648.         You can also combine a menu and the command you want to execute in
  1649.         that menu all into a "/" command.  Let's use the previous example
  1650.         of wanting to know how much time you had left on-line.  Instead of
  1651.         typing "/userlog" to get to the userlog and then [Y] to see your
  1652.         stats, you could simply type "/userlog/y" which would tell Jet to
  1653.         execute the [Y] command in the userlog with you not even having to
  1654.         move from your present location on the board.
  1655.  
  1656.         A "/" command can also act as a password.  Let's say that you only
  1657.         wanted a certain person to be able to chat with you and didn't
  1658.         want to ever be disturbed by anyone else.  You could change the
  1659.         "/chat" command to something that only that person would know.
  1660.  
  1661.         ;entry          command                          level  print
  1662.  
  1663.         abcdefg,        chat,                               1,  ;
  1664.  
  1665.         By entering "/abcdefg" the person would then be able to execute
  1666.         the chat command.  This is a good example of how flexible the MNU
  1667.         files are.  Anything you wish may be put in the "entry" part of
  1668.         the MNU files.
  1669.  
  1670.         The next portion of the MNU files that we will look at will be the
  1671.         commands.  As previously described, the "command" is the portion
  1672.         of the MNU file that tells JetBBS what to do when a specific key
  1673.         is hit, or a "/" command is typed in.  Commands are fairly
  1674.         configurable, and can easily be modified.  There is a complete
  1675.         listing of MNU commands included later on in this documentation.
  1676.         For now, we will use several examples to convey the versatility of
  1677.         the MNU files.
  1678.  
  1679.         One of the most common and important MNU commands is the "goto"
  1680.         command.  It can be used to tell the BBS to go to another MNU
  1681.         file.  This is how you move from one place to the next in Jet.
  1682.         The following are some examples of where the "goto" command is
  1683.         used on the BBS.  The following are all commands that are used in
  1684.         your main menu.
  1685.  
  1686.         ;key    command                          level  print
  1687.  
  1688.         a,      goto auto-msg.mnu,                  1,  Auto-Message;
  1689.         b,      goto border.mnu,                    1,  Borderlines;
  1690.         u,      goto userlog.mnu,                   1,  Userlog;
  1691.         p,      goto phone.mnu,                     1,  Phone list;
  1692.  
  1693.         Included with the reference section is a complete listing of all
  1694.         commands that may be used in the MNU files.  You can create your
  1695.         own menus by locating the commands you would like to have in the
  1696.         menu, and then creating a text file.  This text file should be
  1697.         named whatever you would like the menu to be called, with a ".MNU"
  1698.  
  1699.  
  1700.                                       - 28 -
  1701.  
  1702.  
  1703.  
  1704.         file extension.  Make sure you create it in the \BBS\MNU
  1705.         directory.
  1706.  
  1707.         If your menu is going to contain a "[do]" block, then create that
  1708.         first followed by the "[menu]" block.  One of the most common
  1709.         mistakes is forgetting to include an option which will allow the
  1710.         user quit to the previous menu.  In most circumstances, the
  1711.         "gotoprev" command should be used.  The only thing left to do is
  1712.         create a command elsewhere on the BBS which will access this MNU
  1713.         file.  The command should use the "goto" command to tell the BBS
  1714.         to go to your menu.
  1715.  
  1716.         MNU FILE "[DO]" BLOCK
  1717.  
  1718.         The "[do]" block of a menu file contains a list of commands to be
  1719.         executed as soon as a user enters the menu.  Earlier, we discussed
  1720.         FIRST.MNU which is made up entirely of a "[do]" block.  The user
  1721.         has no choice about whether the commands in the "[do]" block are
  1722.         executed, they are automatic.  A common command you may want to
  1723.         place in the "[do]" block of a menu would be "help", which
  1724.         instructs JetBBS to display the menu.  This way, the menu would
  1725.         display automatically every time a user enters it, instead of
  1726.         waiting for them to press "?".  That is only one of the numerous
  1727.         commands you can place in the "[do]" block.  You can place any MNU
  1728.         command in the "[do]" block if you want them to be automatically
  1729.         executed.
  1730.  
  1731.         You should note that if you add a "[do]" block to a menu, you will
  1732.         no longer be able to preload that menu.  You should then remove
  1733.         that menu from the "Preload:" sequence in the BBS.INI file.  This
  1734.         should not cause a considerable slow down unless you are running
  1735.         JetBBS on a floppy drive.  You may then want to consider only
  1736.         adding a "[do]" block to menus that are not preloaded.
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.                                       - 29 -
  1762.  
  1763.  
  1764.  
  1765.                  Chapter 10 - MNU %variable% Replacement Keywords
  1766.  
  1767.         USER INFO
  1768.  
  1769.             %name%            - Name
  1770.             %usernumber%      - Account number
  1771.             %level%           - Access level
  1772.             %calls%           - Total calls
  1773.             %callsleft%       - Calls left today
  1774.             %callstoday%      - Calls used today
  1775.             %minutesonline%   - Time used so far on this call
  1776.             %minutesleft%     - Time left
  1777.             %posts%           - Total messages posted by user
  1778.             %linesposted%     - Lines posted, calculated by characters
  1779.                                   posted divided by 80
  1780.             %callswhileaway%  - Number of calls since user's last call
  1781.             %lastcalldate%    - Example: "Monday, May 15, 8:32pm"
  1782.             %credits%         - Credits
  1783.             %userinfo1%       - User info fields
  1784.             %userinfo2%
  1785.             %userinfo3%
  1786.             %userinfo4%
  1787.             %userinfo5%
  1788.             %userinfo1desc%   - Descriptions of user info fields
  1789.             %userinfo2desc%
  1790.             %userinfo3desc%
  1791.             %userinfo4desc%
  1792.             %userinfo5desc%
  1793.  
  1794.         MESSAGE BASE
  1795.  
  1796.             %totalmsgs%       - Total messages on the message base
  1797.             %totalnewmsgs%    - Total new messages for this user
  1798.             %room%            - Current room number
  1799.             %roomname%        - Current room name
  1800.             %firstmsg%        - First message number in room
  1801.             %lastmsg%         - Last message number in room
  1802.             %sub%             - Sub-Board number, 0 is Main Message Base
  1803.  
  1804.         GENERAL
  1805.  
  1806.             %prefix%          - The current menu name
  1807.             %newuserstring%   - The string that new users have to type to
  1808.                                   log on as new
  1809.             %firstmenu%       - The MNU file to start with, normally
  1810.                                   FIRST.MNU
  1811.  
  1812.         DIRECTORIES
  1813.                                                                 default:
  1814.             %sysdir%          - BBS data files                  SYS\
  1815.             %textdir%         - Text files that you can edit    TEXT\
  1816.             %menudir%         - MNU files, configurable menus   MNU\
  1817.             %msgdir%          - Messages, stored in text format MSG\
  1818.             %bbsmaildir%      - Private mail                    BBSMAIL\
  1819.             %logfile%         - Path and filename of log file   LOG.TXT
  1820.  
  1821.  
  1822.                                       - 30 -
  1823.  
  1824.  
  1825.  
  1826.         TRANSFERS
  1827.  
  1828.             %transname%       - Name of transfer area, such as "Upload To
  1829.                                   Sysop"
  1830.             %dldir%           - Directory for downloads, set by gototrans
  1831.             %uldir%           - Directory for uploads, set by gototrans
  1832.             %xferfilename%    - File to transfer, set by gotoupload or
  1833.                                   gotodownload
  1834.  
  1835.         MODEM
  1836.  
  1837.             %comport%         - COM port
  1838.             %baud%            - Baud speed currently connected at
  1839.  
  1840.         SPECIAL CHARACTERS
  1841.  
  1842.             %cr%              - "<newline>"
  1843.             %bs%              - "<backspace>"
  1844.             %comma%           - ","
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.                                       - 31 -
  1884.  
  1885.  
  1886.  
  1887.                         Chapter 11 - MNU Command Reference
  1888.  
  1889.           `command` = An MNU command.
  1890.         <parameter> = Required parameter.
  1891.         [parameter] = Optional parameter.  Usually the user is prompted
  1892.                         for this information if it is omitted.
  1893.  
  1894.         AUTO-MESSAGE
  1895.  
  1896.             postautomessage
  1897.                 Posts the Auto-Message and marks it as new.  It will be
  1898.                 read to the next 30 callers and then only to users who
  1899.                 haven't seen it once.
  1900.  
  1901.             checkboardnews
  1902.                 Prints the Board News message if it is new.  See also
  1903.                 `postboardnews` in the "sysop" section.
  1904.  
  1905.             checkautomessage
  1906.                 Prints the Auto-Message if it is new.
  1907.  
  1908.         BANK
  1909.  
  1910.             sendcheck [user]
  1911.                 Sends e-mail with credits attached to it.  The credits are
  1912.                 actually on the e-mail letter, so if the recipient never
  1913.                 calls again and his account eventually scrolls, the
  1914.                 credits are lost.
  1915.  
  1916.             sendletterbomb [user]
  1917.                 Sends e-mail with a letterbomb attached to it.  The
  1918.                 letterbomb causes the recipient to get hung up the first
  1919.                 time he reads the message.  The e-mail message is
  1920.                 anonymous, and there is no other way to send anonymous
  1921.                 e-mail.  The price is a very steep 4000cr.
  1922.  
  1923.             buylevel <level> <price>
  1924.                 <level> is the level available for purchase, and <price>
  1925.                 is the price in credits.  The user has to be one level
  1926.                 below the level being purchased, so there's no jumping
  1927.                 over multiple levels at once.  There is a sample of this
  1928.                 command in BANK.MNU that you can uncomment if you want to
  1929.                 use it.
  1930.  
  1931.             borderauthors
  1932.                 For 200cr, the authors of non-anonymous borders can be
  1933.                 viewed.  The `readborders` command is modified for the
  1934.                 remainder of the call to also show authors.  See also
  1935.                 `readborders` and `postborderanon`.
  1936.  
  1937.             buytime <price_per_minute>
  1938.                 Buy time with credits.
  1939.  
  1940.             selltime <credits_given_per_minute_sold>
  1941.                 Sell back time for credits.  See BANK.MNU for more
  1942.                 information.
  1943.  
  1944.                                       - 32 -
  1945.  
  1946.  
  1947.  
  1948.  
  1949.             slot
  1950.             double
  1951.             greed
  1952.             craps
  1953.             roulette
  1954.             six
  1955.             virushunter
  1956.             bignum
  1957.                 Play casino games.
  1958.  
  1959.             slotcredit
  1960.             doublecredit
  1961.             greedcredit
  1962.             crapscredit
  1963.             roulettecredit
  1964.             sixcredit
  1965.             virushuntercredit
  1966.             bignumcredit
  1967.                 Each game has its own credit reserve.  This command dumps
  1968.                 the credits into your account and then asks how much you
  1969.                 want to put back.  This command can be used by game owners
  1970.                 and sysops.
  1971.  
  1972.             slotowner
  1973.             doubleowner
  1974.             greedowner
  1975.             crapsowner
  1976.             rouletteowner
  1977.             sixowner
  1978.             virushunterowner
  1979.             bignumowner
  1980.                 Set the owner of the casino game.  This command can be
  1981.                 used by game owners and sysops.  It allows the game owner
  1982.                 to transfer ownership to another user.
  1983.  
  1984.         BORDER
  1985.  
  1986.             postborder [number]
  1987.                 Posts one of the one line messages that are printed
  1988.                 between commands in the main menu.  Level 1 users may only
  1989.                 post one per call.
  1990.  
  1991.             postborderanon [number]
  1992.                 Same as `postborder` but does not record the name of the
  1993.                 person posting the border.  It costs 700cr to use this
  1994.                 feature.  See also `borderauthors`.
  1995.  
  1996.             readborders
  1997.                 Lists the borders.  If `borderauthors` has been used, this
  1998.                 command also lists the authors of the borders.  See also
  1999.                 `borderauthors`.
  2000.  
  2001.             borderauthors
  2002.                 For 200cr, the authors of non-anonymous borders can be
  2003.                 viewed.  The `readborders` command is modified for the
  2004.  
  2005.                                       - 33 -
  2006.  
  2007.  
  2008.  
  2009.                 remainder of the call to also show authors.  See also
  2010.                 `readborders` and `postborderanon`.
  2011.  
  2012.         DOOR
  2013.  
  2014.             calldoor <command_line>
  2015.             calldoorbat <command_line>
  2016.                 This is the main interface for calling door programs.
  2017.                 JetBBS writes three formats of door chain files:
  2018.  
  2019.                      Chain file     Other BBSes that use it
  2020.                      ----------     -----------------------
  2021.                      DORINFO1.DEF   RBBS, QBBS, FoReM, TPB, T.A.G.
  2022.                      CALLINFO.BBS   Wildcat!
  2023.                      CHAIN.TXT      WWIV, Telegard
  2024.  
  2025.                 Door programs must read one of these files to find out
  2026.                 necessary information such as the COM port, baud speed,
  2027.                 the user's name, etc.  Ways of telling the door program
  2028.                 where to find the chain file vary from program to program.
  2029.                 In most cases you will need to write a short batch file to
  2030.                 set up a door, if one is not already supplied with the
  2031.                 door.  If the door takes a command line parameter naming
  2032.                 the directory and filename of the chain file, the batch
  2033.                 file is usually like this:  (supposing the name of the
  2034.                 program is "SPACEWAR" and it is in the directory
  2035.                 C:\BBS\SW)
  2036.  
  2037.                      CD SW
  2038.                      SPACEWAR ..\DORINFO1.DEF
  2039.                      ..\SCROLLDN
  2040.                      CD ..
  2041.  
  2042.                 The reason I added ..\SCROLLDN is to scroll the screen
  2043.                 down 4 lines on exit so the BBS's status bar doesn't cover
  2044.                 up important error information at the top of the screen if
  2045.                 something goes wrong.  ..\SCROLLDN is not essential.
  2046.                 Other door programs assume the chain file is in the same
  2047.                 directory, so the batch file should copy it into the
  2048.                 directory.  For example:
  2049.  
  2050.                      COPY DORINFO1.DEF SW
  2051.                      CD SW
  2052.                      SPACEWAR
  2053.                      ..\SCROLLDN
  2054.                      CD ..
  2055.  
  2056.                 Those are the two most typical ways, but door programs
  2057.                 vary widely.  TradeWars looks through the directories
  2058.                 listed in your PATH environment variable, so you have to
  2059.                 make sure the BBS's directory is in your path.  There are
  2060.                 others that have to convert the door file to their own
  2061.                 special format first, so they supply their own batch file
  2062.                 for you to run.  You can use the [6] command in the sysop
  2063.                 menu to add a calldoor command to your DOOR.MNU file.  The
  2064.  
  2065.  
  2066.                                       - 34 -
  2067.  
  2068.  
  2069.  
  2070.                 command line you give it is just the name of the batch
  2071.                 file.
  2072.  
  2073.             calldoorexe <command_line>
  2074.             calldoorcom <command_line>
  2075.                 Similar to `calldoor`, but does not use COMMAND.COM, so
  2076.                 batch files cannot be called.  This way is slightly faster
  2077.                 and uses a little less memory, but it is incompatible with
  2078.                 most door programs, because they require a short batch
  2079.                 file that "cd"'s into the door directory and back out
  2080.                 afterwards.
  2081.  
  2082.             setdoordir <directory>
  2083.                 For calling door programs on a multi-line board, it is
  2084.                 necessary to get the door files in a different directory
  2085.                 for each line.  The recommended way that is given in
  2086.                 DOOR.MNU is `setdoordir` DOOR%com%.  MKDIR the directories
  2087.                 DOOR0 through DOOR4 and then call your door programs with
  2088.                 a parameter to set the path of the door file.  For
  2089.                 example, `calldoor` DOORPROG.BAT
  2090.                 C:\BBS\DOOR%com%\DORINFO1.TXT.  DOORPROG.BAT should then
  2091.                 pass the parameter to the program by using the batch file
  2092.                 %1 variable.  For example:
  2093.  
  2094.                      CD SW
  2095.                      SPACEWAR %1
  2096.                      ..\SCROLLDN
  2097.                      CD ..
  2098.  
  2099.                 If the door program does not allow you to specify the path
  2100.                 of the chain file, setting it up for multi-line can be
  2101.                 more difficult.
  2102.  
  2103.             setdoornum <number>
  2104.                 For calling door programs with the DORINFO1.DEF chain file
  2105.                 on a multi-line BBS, this command changes the "1" in the
  2106.                 filename to a number from 0 to 9.
  2107.  
  2108.         GOTO
  2109.  
  2110.             goto <menu.mnu>
  2111.                 Goes to <menu.mnu>.  If it has a "[do]" block, that is
  2112.                 executed, then if the "[do]" block does not send it
  2113.                 somewhere else, the "[menu]" block defines the current
  2114.                 menu.
  2115.  
  2116.             gotoh <menu.mnu>
  2117.                 Does a `goto` and then does `help`.
  2118.  
  2119.             gotomsg <menu.mnu> [sub-board_number]
  2120.                 This is a special `goto` command for going to the main
  2121.                 message base or a sub-board.  It sets up the room number
  2122.                 and other information.  For [sub-board_number], give 0 for
  2123.                 the main message base or a number to go directly to a sub-
  2124.                 board, or leave it blank to get the list of sub-board ads
  2125.                 and be prompted for a sub-board number.
  2126.  
  2127.                                       - 35 -
  2128.  
  2129.  
  2130.  
  2131.  
  2132.             gotoprev
  2133.                 Does a `goto` to the previous menu.  The sysop menu uses
  2134.                 this to return to where-ever the sysop menu command was
  2135.                 pressed.  `gotoprev` is handy for the quit command in any
  2136.                 menu.  Since you don't have to specify what the previous
  2137.                 menu is, it will be flexible if there are changes later.
  2138.  
  2139.             gotoifaccess <access_options> <menu.mnu> [text]
  2140.                 Does a `goto` to <menu.mnu> if the user has any of the
  2141.                 <access_options>, or prints [text], if it is given, if the
  2142.                 user does not have any of the access options.  For
  2143.                 example:
  2144.  
  2145.                      gotoifaccess ABC DOOR.MNU Sorry%comma% not allowed
  2146.  
  2147.                 If the user has access option A, B, or C, it will go to
  2148.                 the door menu, otherwise it will print the "Sorry, not
  2149.                 allowed" message.
  2150.  
  2151.             gotoifnotaccess <access_options> <menu.mnu> [text]
  2152.                 Opposite of `gotoifaccess`.
  2153.  
  2154.             if <arg1> <operator> <arg2> goto <menu.mnu>
  2155.                 Conditional `goto`.  Important: There must be spaces
  2156.                 between <operator> and <arg1> and <arg2>.  <operator> can
  2157.                 be "==", "<", or ">".  The "<" and ">" can only be used on
  2158.                 numbers, but the "==" can be used for either text or
  2159.                 numbers.  The `if` command is generally used with
  2160.                 %replacement% keywords, like in the commented out line in
  2161.                 FIRST.MNU that you can enable to disallow 300 baud
  2162.                 callers:
  2163.  
  2164.                      if %baud% == 300 GOTO NO300.MNU
  2165.  
  2166.                 In this release, the only command allowed after the
  2167.                 condition is `goto`.  It is possible that future releases
  2168.                 will allow any command statement there.
  2169.  
  2170.             ifnot <arg1> <operator> <arg2> goto <menu.mnu>
  2171.                 Similar to `if`, but performs the `goto` when the
  2172.                 condition is not true.
  2173.  
  2174.         LOGOFF
  2175.  
  2176.             logoff
  2177.                 Confirms logoff, updates newscan pointers, prints
  2178.                 LOGOFF.TXT, and hangs up.  Logoff can be aborted at the
  2179.                 last minute by pressing [A] to abort the logoff message.
  2180.  
  2181.             logoffkeep
  2182.                 Same as logoff, but does not update newscan pointers.
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.                                       - 36 -
  2189.  
  2190.  
  2191.  
  2192.             fastlogoff
  2193.                 Just hangs up without confirming logoff, updating newscan
  2194.                 pointers, or printing LOGOFF.TXT.  There is no opportunity
  2195.                 for the user to cancel the logoff.
  2196.  
  2197.         MAIL
  2198.  
  2199.             checkmail
  2200.                 Read mail.  By default, this command is used in FIRST.MNU,
  2201.                 and is also available by the /rereadmail command.
  2202.  
  2203.             sendmail [user]
  2204.                 Send e-mail.  [user] can be a name, number, or keyword to
  2205.                 search for.  If [user] is omitted, the user is prompted.
  2206.  
  2207.             feedback
  2208.                 Similar to `sendmail` except that account 1 is
  2209.                 automatically the recipient.  If CarbonCopyFeedbackTo in
  2210.                 BBS.INI is set to a user number, a copy of the feedback
  2211.                 will be sent to that user.  This is useful if there is a
  2212.                 co-sysop.
  2213.  
  2214.         MESSAGE BASE
  2215.  
  2216.             post
  2217.                 Post a message.  If PayCreditsForPosting in BBS.INI has
  2218.                 not been set to 0, the user gets 25 credits per line for
  2219.                 his post, unless the message is anonymous.  For reasons
  2220.                 not explained here, the message will be anonymous if the
  2221.                 key used to invoke the command is [Y].
  2222.  
  2223.             readmsg [number]
  2224.                 Start reading at specified message number.
  2225.  
  2226.             newscan
  2227.                 Read new messages in this room if any.
  2228.  
  2229.             gotonew
  2230.                 Go to the next room that has new messages.  Citadel users
  2231.                 will find this command familiar.
  2232.  
  2233.             ungotonew
  2234.                 Go backwards to the previous room with new messages.
  2235.  
  2236.             global
  2237.                 Also known as "zipscan".  Goes to every room with new
  2238.                 messages and does a `newscan`.
  2239.  
  2240.             setnewscan
  2241.                 Set newscan pointer by telling how many messages should be
  2242.                 new.
  2243.  
  2244.             roomdown
  2245.                 Go down one room.
  2246.  
  2247.  
  2248.  
  2249.                                       - 37 -
  2250.  
  2251.  
  2252.  
  2253.             roomup
  2254.                 Go up one room.
  2255.  
  2256.             roomjump [number]
  2257.                 Go directly to a room number.  Sysops can use this command
  2258.                 to get to any room, regardless of the access level.
  2259.  
  2260.             knownrooms
  2261.                 Lists rooms that the user has access to, and notes which
  2262.                 ones have access level above 1 or have a subop.  Vertical
  2263.                 spacing is inserted between 9 and 10, 19 and 20, and 29
  2264.                 and 30 to make it easier to read.
  2265.  
  2266.             delmsgbyuser [number]
  2267.                 Allows a user to delete his own messages.
  2268.  
  2269.         MISCELLANEOUS
  2270.  
  2271.             chat
  2272.                 Chat call.  Produces a short, low pitch tone.  If
  2273.                 ChatCommand in BBS.INI is set to a DOS command, the DOS
  2274.                 command will be executed instead.  Neither action is taken
  2275.                 if SCROLL LOCK is turned on.  Instead, the user is told
  2276.                 that the sysop is unavailable.
  2277.  
  2278.             chatloud
  2279.                 A variation of the `chat` command, but louder.  The use of
  2280.                 ChatCommand and SCROLL LOCK are the same as for `chat`.
  2281.  
  2282.             version
  2283.                 Display version and copyright notice.
  2284.  
  2285.             rem [ignored]
  2286.                 No action.
  2287.  
  2288.             cls
  2289.                 Clear screen.
  2290.  
  2291.             jetbbs
  2292.                 The Self-Download feature.
  2293.  
  2294.             dochat
  2295.                 Chat mode.  To exit, press [@].  By default, the key for
  2296.                 this command is [@] and is global.
  2297.  
  2298.             calldos <command_line>
  2299.                 Executes a DOS command.  This command requires more memory
  2300.                 than usual, typically about 60k more plus any additional
  2301.                 memory used by whatever is executed.  Remember that
  2302.                 whatever is printed on the screen while executing another
  2303.                 program through this command is not sent through the modem
  2304.                 unless the program is specifically designed to do so.
  2305.                 What's worse, if the program asks a question and waits for
  2306.                 a key to be pressed, it will go to the local keyboard and
  2307.                 there will be no way for a remote user to make it continue
  2308.  
  2309.  
  2310.                                       - 38 -
  2311.  
  2312.  
  2313.  
  2314.                 until someone presses the key locally.  See also
  2315.                 `sysopcalldos`.
  2316.  
  2317.             callexe <command_line>
  2318.                 Similar to `calldos`, but does not use COMMAND.COM, so it
  2319.                 cannot call batch files, but it is a slightly faster and
  2320.                 uses less memory than `calldos`.
  2321.  
  2322.             editfile <filename> [headernumber]
  2323.                 Uses the message editor to write the specified file.
  2324.                 <filename> must be set in the MNU file; it is not intended
  2325.                 for users to specify a file to write.  See the
  2326.                 `sysopeditfile` command if you want to read in, edit, and
  2327.                 save a file that is specified at the time the command is
  2328.                 used.
  2329.                     The [headernumber] codes are:
  2330.  
  2331.                      0 = No header
  2332.                      1 = Message
  2333.                      2 = E-mail
  2334.                      3 = Check
  2335.                      4 = Letterbomb
  2336.                      5 = Anonymous
  2337.                      6 = Touch
  2338.  
  2339.             setprompt <text>
  2340.                 Sets the command prompt.  A ": " is added to the end, so
  2341.                 leave the colon off in <text>.  You can use %var%
  2342.                 replacement keywords in the prompt.  `setprompt` should be
  2343.                 used in the "[do]" block of MNU files.  An example for
  2344.                 SUB.MNU:
  2345.  
  2346.                      [do]
  2347.                      setprompt %sub%/%room%-%roomname%
  2348.                      [menu]
  2349.                      ...
  2350.  
  2351.         MULTI-LINE
  2352.  
  2353.             who
  2354.                 Lists users on-line and the ports they're on.  If
  2355.                 RamDriveDir is set, it also tells their location.
  2356.  
  2357.             location <text>
  2358.                 Sets the location field shown in the `who` command.  The
  2359.                 command has no effect if RamDriveDir (in BBS.INI) is not
  2360.                 set.
  2361.  
  2362.             touch [user] [message]
  2363.                 Sends a message to a user on-line, which is received the
  2364.                 next time he gets to a command prompt, or immediately if
  2365.                 he is already sitting at one.  If [message] or both [user]
  2366.                 and [message] are omitted, the sender is prompted for the
  2367.                 information.  The command is rejected if the recipient is
  2368.                 not on-line.
  2369.  
  2370.  
  2371.                                       - 39 -
  2372.  
  2373.  
  2374.  
  2375.             broadcast [message]
  2376.                 Sends a message to all users on-line except the sender.
  2377.                 If [message] is omitted, the user is prompted for it.
  2378.                 Although the command line can only take 80 characters, the
  2379.                 message prompt will accept up to 4 lines, so larger
  2380.                 messages can be sent by letting it prompt.
  2381.  
  2382.             setdoordir <directory>
  2383.                 See door section.
  2384.  
  2385.             setdoornum <number>
  2386.                 See door section.
  2387.  
  2388.         PHONE LIST
  2389.  
  2390.             readphonelist
  2391.                 Print the phone list.
  2392.  
  2393.             phonelist
  2394.                 Add a new BBS to the end of the phone list.
  2395.  
  2396.         PRINT
  2397.  
  2398.             print [text]
  2399.                 Prints a line of text.  If [text] is omitted, a blank line
  2400.                 is printed.
  2401.  
  2402.             printtolog [text]
  2403.                 Prints like the `print` command but prints to LOG.TXT.
  2404.  
  2405.             pause [text]
  2406.                 Prints [text] like the `print` command, then waits for a
  2407.                 keypress.  Unlike `print`, nothing is printed if [text] is
  2408.                 omitted.
  2409.  
  2410.             printfile <filename> [text]
  2411.                 Prints a file.  If [text] is given, it is printed before
  2412.                 the first line, but only if the file is found.  If the
  2413.                 file is not found, nothing is printed.
  2414.  
  2415.             help
  2416.                 Prints the .HLP file in TextDir corresponding to the menu
  2417.                 name.  If a key is pressed, the printing is aborted and
  2418.                 the key is sent through to the menu, so you don't have to
  2419.                 wait for the menu to finish before pressing the key
  2420.                 command.  The exception is for the [P] key, which pauses.
  2421.  
  2422.         SUB-BOARDS
  2423.  
  2424.             subknown
  2425.                 Lists the rooms accessible at the user's Sub-Board access
  2426.                 level, in a slightly different format from the regular
  2427.                 knownrooms.
  2428.  
  2429.  
  2430.  
  2431.  
  2432.                                       - 40 -
  2433.  
  2434.  
  2435.  
  2436.             postsubad
  2437.                 Posts the one-line advertisement that is listed before
  2438.                 choosing a Sub-Board.  It only shows up to users who have
  2439.                 access.
  2440.  
  2441.             writetitlepage
  2442.                 Posts the title page printed as users enter the Sub-Board.
  2443.                 If one exists already, it is read into the editor buffer
  2444.                 to be edited.  To start over from scratch, enter ".c".
  2445.  
  2446.             subuser [user]
  2447.                 Set a user's Sub-Board access level.  Each Sub-Board has
  2448.                 its own set of access levels.  All users start out at
  2449.                 level 0.  Level 9 gives access to the subop menu, and 99
  2450.                 is the highest allowable level.  A negative levels can be
  2451.                 used to shut a user out of a public Sub-Board.  Subops can
  2452.                 change the level of users below their own access level,
  2453.                 but not equal or above, so they can make sub-subops
  2454.                 without risking being demoted by them.  The restrictions
  2455.                 are waived when a sysop is using the command.
  2456.  
  2457.             listsubusers
  2458.                 This lists everyone who has a Sub-Board access level other
  2459.                 than 0.
  2460.  
  2461.             subopsetsubop
  2462.                 Subop access can be given out on a room by room basis.
  2463.  
  2464.         SYSOP
  2465.  
  2466.             sysopcalldos [command_line]
  2467.                 This is like `calldos` but designed for the sysop to enter
  2468.                 the command line.  The command has RemoteSysopPassword
  2469.                 protection and also warns of some of the possible ways
  2470.                 that the system could get locked up if the wrong program
  2471.                 is executed.
  2472.  
  2473.             sysopshell
  2474.                 This starts a DOS command prompt and directs its input and
  2475.                 output to the modem by executing the DOS command line
  2476.                 "COMMAND <COM# >COM#", where # is the COM port number.
  2477.                 MS-DOS doesn't understand COM3 and COM4, so it only works
  2478.                 for COM1 and COM2 as far as I know.  (DR-DOS users?)  This
  2479.                 command has RemoteSysopPassword protection and also warns
  2480.                 of some of the possible ways that the system could get
  2481.                 locked up if the wrong program is executed.  Since the
  2482.                 input and output are redirected to the modem, some
  2483.                 programs can take input over the modem, but there are
  2484.                 others that go directly to the keyboard hardware and still
  2485.                 aren't redirected.
  2486.  
  2487.             sysopviewuser [user]
  2488.                 Shows information about a user, including information that
  2489.                 is only for sysops to see.
  2490.  
  2491.  
  2492.  
  2493.                                       - 41 -
  2494.  
  2495.  
  2496.  
  2497.             sysopedituser [user]
  2498.                 Edits a user's account.  To improve access level security,
  2499.                 there is a RemoteSysopPassword restriction on creating a
  2500.                 level 8 or above account, and on lowering a level 8 or
  2501.                 above account.  In other words, you have to have the
  2502.                 RemoteSysopPassword to cross the boundary between lv7 and
  2503.                 lv8, in either direction.  Passwords are not displayed
  2504.                 from remote and cannot be set remotely.
  2505.  
  2506.             sysopsettimeleft
  2507.                 Sets the time left for all users or all users of a certain
  2508.                 level.  Admittedly, this command is not very useful.
  2509.                 RemoteSysopPassword protected.
  2510.  
  2511.             sysopaddtime [user]
  2512.                 Add time to an account.  This is a quicker, easier way to
  2513.                 add time than using sysopedituser, doing the addition in
  2514.                 your head, and re-entering the total time.  If a user's
  2515.                 time left exceeds MinutesPerDay set in BBS.INI, it will
  2516.                 not be affected until it falls below MinutesPerDay.
  2517.                 MinutesPerDay never pulls it down.  On a pay system, you
  2518.                 can give out time to paying users and set MinutesPerDay to
  2519.                 the freebie daily time that users get if they haven't paid
  2520.                 or if they've run out of paid time.
  2521.  
  2522.             sysopdeleteuser [user]
  2523.                 Sets a user's access level to -1 so when he tries to log
  2524.                 on he will see the file DELETED.TXT and be logged off.
  2525.                 This is the same as using sysopedituser to set level -1.
  2526.                 RemoteSysopPassword protected.
  2527.  
  2528.             sysopdelmsg [number]
  2529.                 Delete a message and copy it into LOG.TXT.  If you want to
  2530.                 revoke credits, you have to do it yourself.  Usually the
  2531.                 posting credits will still be in "Delayed posting credits"
  2532.                 so you can revoke them before the offender has even
  2533.                 received them.
  2534.  
  2535.             sysopreadlog
  2536.                 First flushes out any log entries still stored in memory,
  2537.                 then prints LOG.TXT.
  2538.  
  2539.             sysopdellog
  2540.                 Delete LOG.TXT.
  2541.  
  2542.             sysopreadfile [filename]
  2543.                 Views a text file.  RemoteSysopPassword protected.
  2544.  
  2545.             sysopeditfile [filename]
  2546.                 Uses the message editor to edit a text file.  If the file
  2547.                 already exists, it is read into the editor buffer.  To
  2548.                 stop the listing, press space.  If you would rather start
  2549.                 from scratch, type ".c" to clear out the old file.
  2550.                 Usually, [filename] is not specified in MNU file, so the
  2551.                 sysop can specify it at the time the command is used.
  2552.                 RemoteSysopPassword protected.
  2553.  
  2554.                                       - 42 -
  2555.  
  2556.  
  2557.  
  2558.             sysoppostnews
  2559.                 Posts the Board News message and marks it as new.  It will
  2560.                 be read to the next 30 callers and then only to users who
  2561.                 haven't seen it once.
  2562.  
  2563.             sysopsetroomname
  2564.                 Sets a room's name and access level.  Press enter on a
  2565.                 blank line if you don't want to change something.
  2566.  
  2567.             sysopsetroomaccess
  2568.                 Sets room access options.  If any access options are set,
  2569.                 users must have one of the access options as well as the
  2570.                 required access level to access the room.
  2571.  
  2572.             sysopsetsubop
  2573.                 This sets the subop of an individual room.  The specified
  2574.                 user can press & in the room to access the subop menu to
  2575.                 name the room, set the access level, and delete messages.
  2576.  
  2577.             sysopopenclosesub
  2578.                 Toggles a Sub-Board open or closed.  This is the same as
  2579.                 setting the access level of the first room to 0 or 100.
  2580.  
  2581.             sysopeditxferareamnu
  2582.                 Uses a special editor to edit XFERAREA.MNU.
  2583.  
  2584.             sysopeditdoormnu
  2585.                 Uses a special editor to edit DOOR.MNU.
  2586.  
  2587.         TRANSFER
  2588.  
  2589.             gototrans <download_dir> <upload_dir> <x-fer_section_name>
  2590.                 Sets the transfer area and performs a `goto` to the menu
  2591.                 X-FER.MNU.  To make a download-only transfer section, set
  2592.                 <upload_dir> to NOUPLOADDIR.  For an upload-only transfer
  2593.                 section, set <download_dir> to NODOWNLOADDIR.  This
  2594.                 command sets the replaceable keywords %dldir%, %uldir%,
  2595.                 and %transname%.
  2596.  
  2597.             gotodownload
  2598.                 This command lets the user search FILES.TXT for a file to
  2599.                 download.  If one is found, it performs a `goto` to
  2600.                 DL.MNU.  The filename is stored in %xferfilename%.
  2601.  
  2602.             gotoupload
  2603.                 Asks for the filename of the upload and then does a `goto`
  2604.                 to UL.MNU.  The filename is stored in %xferfilename%.
  2605.  
  2606.             xmodemsend <filename>
  2607.                 Download a file using built-in Xmodem.  This command is
  2608.                 used in DL.MNU like this:
  2609.  
  2610.                      xmodemsend %xferfilename%
  2611.  
  2612.  
  2613.  
  2614.                                       - 43 -
  2615.  
  2616.  
  2617.  
  2618.             xmodemreceive <filename>
  2619.                 Upload a file using built-in Xmodem.  This command is used
  2620.                 in UL.MNU like this:
  2621.  
  2622.                      xmodemreceive %xferfilename%
  2623.  
  2624.             asciidl [filename]
  2625.                 Download a file as ASCII.  The user is prompted for the
  2626.                 filename if [filename] is omitted, but usually the
  2627.                 filename is given by %xferfilename%.
  2628.  
  2629.             asciiul [filename]
  2630.                 Upload a file as ASCII.  The user is prompted for the
  2631.                 filename if [filename] is omitted, but usually the
  2632.                 filename is given by %xferfilename%.
  2633.  
  2634.             transdl2 <command_line>
  2635.                 Calls an external transfer protocol by using `calldos`.
  2636.  
  2637.             transul2 <command_line>
  2638.                 Calls an external transfer protocol by using `calldos`.
  2639.                 If the return code from the transfer indicates success, it
  2640.                 prompts for a file description and adds a line to
  2641.                 FILES.TXT.  See also `calldos`.
  2642.  
  2643.             addunlistedfiles
  2644.                 This command searches the download directory for files not
  2645.                 listed in FILES.TXT.
  2646.  
  2647.         USERLOG
  2648.  
  2649.             listusers
  2650.                 Lists the entire userlog.  At the end, it prints the
  2651.                 richest user that it found, based on how many credits the
  2652.                 user had in the bank.  Credit in the mail or in a casino
  2653.                 game is not counted, and sysops are not included in the
  2654.                 search.
  2655.  
  2656.             callingtimeschart
  2657.                 Displays a spiffy looking 3D bar chart of the frequency of
  2658.                 calls at each hour of the day.
  2659.  
  2660.             viewcallerlog
  2661.                 Lists the last few callers and when they called.  The
  2662.                 length of the list is controlled by the length of the file
  2663.                 SYS\CALLERS.TXT.  To make the list shorter, delete lines
  2664.                 from the file; to make it longer, add lines.
  2665.  
  2666.             viewuser [user]
  2667.                 Prints information about another user that is considered
  2668.                 OK to give out to non-sysops.  The sysop version of this
  2669.                 is `sysopviewuser`.
  2670.  
  2671.  
  2672.  
  2673.  
  2674.  
  2675.                                       - 44 -
  2676.  
  2677.  
  2678.  
  2679.             userlogbystring [keyword]
  2680.                 Searches the userlog by a text keyword.  The following
  2681.                 fields are searched:
  2682.  
  2683.                      Name
  2684.                      UserInfo1
  2685.                      UserInfo2
  2686.                      Last call date
  2687.                      Level
  2688.                      Calls
  2689.  
  2690.             userlogbynumber
  2691.                 Searches the userlog by one of 6 numeric user info fields,
  2692.                 listing all that are greater or less than a certain value.
  2693.  
  2694.             userpreferences
  2695.                 Configures a few things about the BBS on a per-user basis.
  2696.  
  2697.             viewyourself
  2698.                 This command was replaced by STATS.MNU, and does about the
  2699.                 same thing.
  2700.  
  2701.             zapstats
  2702.                 Re-enter user information.
  2703.  
  2704.             changepassword
  2705.                 Change password.
  2706.  
  2707.         VOTING POLL
  2708.  
  2709.             pollvote
  2710.                 Vote.  Voting is allowed once per call.
  2711.  
  2712.             viewpoll
  2713.                 View the results of the voting polls.
  2714.  
  2715.             makepoll [number]
  2716.                 Make a new voting poll.  Enter the question, then enter up
  2717.                 to eight choices.  If you don't need all eight choices,
  2718.                 press enter on a blank line to finish.  To delete a poll,
  2719.                 press enter on a blank line for the question and for the
  2720.                 first choice.
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.                                       - 45 -
  2737.  
  2738.  
  2739.  
  2740.                           Chapter 12 - Software License
  2741.  
  2742.         SOFTWARE LICENSE
  2743.  
  2744.         You are free to copy and distribute JETSETUP.EXE and JETBBS.DAT
  2745.         so long as they are not modified in any way and they are
  2746.         distributed together.  You may use JetBBS for an evaluation period
  2747.         of 90 days, but after that you must register if you are going to
  2748.         continue to use it.  See the registration form at the end of this
  2749.         document or the file REGISTER.FRM for registration instructions.
  2750.  
  2751.         DISCLAIMER
  2752.  
  2753.         This software is provided on an "as is" basis without warranty of
  2754.         any kind, expressed or implied, including but not limited to the
  2755.         implied warranties of merchantability and fitness for a particular
  2756.         purpose.  The author will not be liable for any special,
  2757.         incidental, consequential, indirect or similar damages due to loss
  2758.         of data or any other reason, even if the author or an agent of the
  2759.         author has been advised of the possibility of such damages.  In no
  2760.         event shall the author's liability for any damages ever exceed the
  2761.         price paid for the license to use the software, regardless of the
  2762.         form of the claim.  The person using the software bears all risk
  2763.         as to the quality and performance of the software.
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.  
  2780.  
  2781.  
  2782.  
  2783.  
  2784.  
  2785.  
  2786.  
  2787.  
  2788.  
  2789.  
  2790.  
  2791.  
  2792.  
  2793.  
  2794.  
  2795.  
  2796.  
  2797.                                       - 46 -
  2798.  
  2799.  
  2800.  
  2801.                    Chapter 13 - Wish List for the Next Version
  2802.  
  2803.         These are some of the new features that I will be working on for
  2804.         the next version.  They will be available in the registered
  2805.         versions as each is written.  If you're registering and you're
  2806.         especially interested in a particular feature or features, or you
  2807.         have some ideas of your own, please make a note of it on your
  2808.         registration form, or print out this list and check off items.  If
  2809.         the features you want are not already in the registered version
  2810.         that I send you at the time you registered, I will send you a
  2811.         second disk later when they become available.
  2812.  
  2813.             - Separate newscan pointers for each room.
  2814.  
  2815.             - Better e-mail.
  2816.  
  2817.             - Swap out to disk to give door programs more memory.
  2818.  
  2819.             - Make a new BBS.INI option to detect ANSI or ask "Do you have
  2820.                 ANSI?" at logon, and use a separate set of .HLP and .TXT
  2821.                 files if so.
  2822.  
  2823.             - Limit the number of chat calls.
  2824.  
  2825.             - Indicator on the status bar if there has been a chat call
  2826.                 during the call.
  2827.  
  2828.             - More multi-line features.
  2829.  
  2830.             - Allow the user to turn off broadcasts and touches.
  2831.  
  2832.             - Read messages posted by a particular user.
  2833.  
  2834.             - More command line options to allow mail front ends.
  2835.  
  2836.             - Optional sets of MNU and HLP files to emulate other BBSes,
  2837.                 such as Citadel.
  2838.  
  2839.             - More efficient storage of messages.
  2840.  
  2841.             - Make command line control for IMPORT.EXE, so it can be used
  2842.                 to automatically add messages to the message base from
  2843.                 another source.
  2844.  
  2845.             - Allow the local video to be turned off to speed it up for
  2846.                 the remote user.
  2847.  
  2848.             - Make sure 9600 baud works.
  2849.  
  2850.             - An OS/2 version, if there's demand for it.
  2851.  
  2852.             - Yield unused CPU time to DESQview.
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.                                       - 47 -
  2859.  
  2860.  
  2861.  
  2862.                           Chapter 14 - Registration Form
  2863.  
  2864.  
  2865.    Name___________________________________________________________
  2866.  
  2867.    Address________________________________________________________
  2868.  
  2869.    City___________________________State_________Zip_______________
  2870.  
  2871.  
  2872.    (Optional) Name of your BBS: __________________________________________
  2873.  
  2874.    (Optional) BBS Phone number: (_______)_________________________________
  2875.  
  2876.    Do you want your BBS number to be
  2877.    published in the next release of JetBBS?   [ ] YES  [ ] NO
  2878.  
  2879.  
  2880.    JetBBS Registration . . . . . . . . . . . . . $34           ___________
  2881.  
  2882.        - Latest registered version, without self-download, and
  2883.            including new features from the wish list not yet
  2884.            released to shareware.
  2885.        - Latest shareware version.
  2886.        - Free newsletter.
  2887.        - Printed manual.
  2888.  
  2889.  
  2890.    Disk of shareware door games and DSZ  . . . . $2            ___________
  2891.  
  2892.        - Includes instructions and .BAT, .HLP, and .MNU files
  2893.            to easily set up for JetBBS.
  2894.        - DSZ external transfer protocol for Ymodem and Zmodem.
  2895.  
  2896.  
  2897.    Disk format
  2898.  
  2899.        [ ] 1.2 meg, 5.25 inch  <- preferred format
  2900.  
  2901.        [ ] 360k, 5.25 inch, add $2                             ___________
  2902.  
  2903.        [ ] 720k, 3.5 inch, add $2                              ___________
  2904.  
  2905.  
  2906.    Shipping, add $3 U.S. and Canada, $8 to foreign addresses   ___________
  2907.  
  2908.  
  2909.    JetBBS Version 1.0                                    Total ___________
  2910.  
  2911.  
  2912.    Make check or money order to:   TROY BECKSTROM
  2913.                                    PO BOX 95724-J
  2914.                                    SEATTLE, WA 98145
  2915.  
  2916.  
  2917.  
  2918.                                       Index
  2919.  
  2920.         %variable%, 10, 30               changepassword, 46
  2921.                                          Chat, 25, 26, 28, 39
  2922.         &C1, 18                          chat, 10, 38
  2923.         &D2, 18                          Chat call, 10, 38
  2924.                                          ChatCommand, 38
  2925.         Access levels, 22, 25, 41, 43    chatloud, 10, 38
  2926.         Add time, 14, 42                 checkautomessage, 32
  2927.         addunlistedfiles, 45             checkboardnews, 32
  2928.         AllowEscChar, 8                  checkmail, 37
  2929.         Anonymous post, 22               Checks, 32
  2930.         ANSI, 8, 48                      cls, 39
  2931.         AnswerOnRing, 18                 Command prompt, 40
  2932.         ASCII, 44                        CONFIG.SYS, 13
  2933.         asciidl, 44                      craps, 33
  2934.         asciiul, 45                      crapscredit, 33
  2935.         Auto-answer, 17, 19              crapsowner, 33
  2936.         Auto-Message, 23, 32             CTRL+BREAK, 26
  2937.         AUTOEXEC.BAT, 13                 CTRL+C, 26
  2938.                                          Customization, 7
  2939.         Bank, 32
  2940.         BANK.MNU, 14, 32, 33             Daily events, 12
  2941.         Batch file, 11                   Delete message, 21
  2942.         BBS List, 23, 40, 49             DELETED.TXT, 43
  2943.         BBS.INI, 8-9, 12-15, 18, 25,     delmsgbyuser, 38
  2944.                  29, 37-42               DESQview, 4, 12
  2945.         bignum, 33                       Dimension Nine BBS, 5
  2946.         bignumcredit, 33                 DL.MNU, 44
  2947.         bignumowner, 33                  dochat, 39
  2948.         Board News, 23, 32, 43           Door chain files, 11, 34
  2949.         Border, 33                       Door programs, 11
  2950.         borderauthors, 32, 34            DOOR.MNU, 11, 35, 44
  2951.         Borderlines, 23                  Doors, 34, 48
  2952.         broadcast, 13, 40                DORINFO1.DEF, 11, 34, 35
  2953.         Buy time, 32                     double, 33
  2954.         buylevel, 32                     doublecredit, 33
  2955.         buytime, 32                      doubleowner, 33
  2956.                                          DTR, 17
  2957.         calldoor, 34
  2958.         calldoorbat, 34                  E-mail, 22, 37
  2959.         calldoorcom, 35                  Edit user, 25
  2960.         calldoorexe, 35                  editfile, 39
  2961.         calldos, 39                      Escape character, 8
  2962.         Caller Log, 24, 45               EVENT.BAT, 12
  2963.         CALLERS.TXT, 24, 45              Events, 12
  2964.         callexe, 39
  2965.         CALLINFO.BBS, 11, 34             fastlogoff, 37
  2966.         callingtimeschart, 45            Features, 4
  2967.         calltimes, 24                    feedback, 37
  2968.         Capture, 25                      File transfers, 23
  2969.         CAPTURE.TXT, 25                  FILES.TXT, 44, 45
  2970.         CarbonCopyFeedbackTo, 37         FIRST.MNU, 10, 29, 30, 36, 37
  2971.         Carrier detect, 17               Forced logoff, 25
  2972.         Casino, 33                       Function keys, 25
  2973.         Chain files, 11, 34
  2974.         CHAIN.TXT, 11, 34                Gameop, 33
  2975.  
  2976.  
  2977.  
  2978.  
  2979.         global, 38                       MNU files, [do] Block, 29
  2980.         GLOBAL.MNU, 27                   MNU files, [menu] block, 27
  2981.         goto, 28, 35-36                  ModemInitStrings, 17
  2982.         Goto new messages, 21            Modems, 17, 18, 19
  2983.         gotodownload, 44                 MSG.MNU, 10, 22
  2984.         gotoh, 36                        MSGFIX utility, 15, 16
  2985.         gotoifaccess, 36                 MSGLIST.DAT, 15
  2986.         gotoifnotaccess, 36              Multi-line, 12-13, 35, 40
  2987.         gotomsg, 36                      Multitasking, 13
  2988.         gotonew, 37
  2989.         gotoprev, 36                     Newscan, 20
  2990.         gototrans, 44                    newscan, 37
  2991.         gotoupload, 44                   Newscan pointers, 21, 37-38, 48
  2992.         greed, 33                        NEWUSER.TXT, 7
  2993.         greedcredit, 33                  NO300.MNU, 36
  2994.         greedowner, 33
  2995.                                          OS/2, 4, 12
  2996.         Hayes compatible, 17
  2997.         help, 41                         Password, 24-25
  2998.                                          pause, 41
  2999.         if, 36                           Pause between messages, 20
  3000.         ifnot, 36                        Pay systems, 14
  3001.         IMPORT utility, 15               PayCreditsForPosting, 14, 37
  3002.         Installation, 6                  Phone list, 23, 40
  3003.                                          phonelist, 40
  3004.         JETBBS.DAT, 6                    PIF, 14
  3005.         JETBBS.PIF, 4, 13                pollvote, 46
  3006.         JETLOCAL.PIF, 14                 post, 37
  3007.         JETBBS.DAT, 6                    postautomessage, 32
  3008.         JETSETUP.EXE, 6                  postborder, 33
  3009.                                          postborderanon, 33
  3010.         knownrooms, 38                   postsubad, 41
  3011.                                          Preload, 29
  3012.         letterbomb, 32                   print, 41
  3013.         listsubusers, 41                 printfile, 41
  3014.         listusers, 45                    printtolog, 41
  3015.         LOCAL, 13
  3016.         location, 40                     RAM drive, 13
  3017.         Lock file, 13                    RamDriveDir, 13, 40
  3018.         LOCK#.TXT, 13                    Read messages, 20
  3019.         LOG.TXT, 43                      readborders, 34
  3020.         logoff, 37                       readmsg, 37
  3021.         LOGOFF.TXT, 7, 37                readphonelist, 40
  3022.         logoffkeep, 37                   RefundPostingTime, 14
  3023.         Logon Messages, 23               REGISTER.FRM, 49
  3024.         LOGON.TXT, 7                     rem, 38
  3025.                                          RemoteSysopPassword, 9, 42, 43
  3026.         Mail, 37                         Replacement keywords, 30
  3027.         MAIN.MNU, 9, 10, 27              roomdown, 38
  3028.         makepoll, 46                     roomjump, 38
  3029.         Message Base, 20, 37             Rooms, 20, 21
  3030.         Message Base Scrolling, 24       roomup, 38
  3031.         Message editor, 21, 39, 43       roulette, 33
  3032.         Microsoft Windows, 4, 12, 13     roulettecredit, 33
  3033.         MidnightEvent, 12                rouletteowner, 33
  3034.         MinutesPerDay, 14, 42
  3035.         Miscellaneous, 38                SCROLLDN.COM, 34
  3036.         MNU files, 9, 10, 27, 28
  3037.  
  3038.  
  3039.  
  3040.  
  3041.         Scrolling, 24                    User info, 24
  3042.         See border authors, 23           UserInfo1, 46
  3043.         selltime, 33                     UserInfo2, 46
  3044.         sendcheck, 32                    Userlog, 23, 45
  3045.         sendletterbomb, 32               Userlog scrolling, 24
  3046.         sendmail, 37                     userlogbynumber, 46
  3047.         Set newscan pointers, 21, 38     userlogbystring, 46
  3048.         setdoordir, 35                   userpreferences, 46
  3049.         setdoornum, 35
  3050.         setnewscan, 38                   version, 38
  3051.         setprompt, 40                    viewcallerlog, 45
  3052.         SHARE, 13                        viewpoll, 46
  3053.         six, 33                          viewuser, 45
  3054.         sixcredit, 33                    viewyourself, 46
  3055.         sixowner, 33                     virushunter, 33
  3056.         slot, 33                         virushuntercredit, 33
  3057.         slotcredit, 33                   virushunterowner, 33
  3058.         slotowner, 33                    Voting polls, 46
  3059.         STATS.MNU, 10, 24, 46
  3060.         Status bar, 25                   who, 13, 40
  3061.         Sub-Boards, 22, 41               Windows, 4, 12, 13
  3062.         SUB.MNU, 40                      Wish list, 48
  3063.         subknown, 41                     writetitlepage, 41
  3064.         subopsetsubop, 42
  3065.         subuser, 41                      X-FER.MNU, 44
  3066.         Sysop, 42                        XFERAREA.MNU, 44
  3067.         sysopaddtime, 42                 Xmodem, 44
  3068.         sysopcalldos, 42                 xmodemreceive, 44
  3069.         sysopdeleteuser, 43              xmodemsend, 44
  3070.         sysopdellog, 43
  3071.         sysopdelmsg, 43                  Your user stats, 24
  3072.         sysopeditdoormnu, 44
  3073.         sysopeditfile, 43                zapstats, 46
  3074.         sysopedituser, 42                Zipscan, 21
  3075.         sysopeditxferareamnu, 44
  3076.         sysopopenclosesub, 44
  3077.         sysoppostnews, 43
  3078.         sysopreadfile, 43
  3079.         sysopreadlog, 43
  3080.         sysopsetroomaccess, 43
  3081.         sysopsetroomname, 43
  3082.         sysopsetsubop, 44
  3083.         sysopsettimeleft, 42
  3084.         sysopshell, 42
  3085.         sysopviewuser, 42
  3086.         System requirements, 4
  3087.  
  3088.         Temporary sysop, 25
  3089.         TextDir, 41
  3090.         touch, 13, 40
  3091.         transdl2, 45
  3092.         Transfers, 23, 44
  3093.         transul2, 45
  3094.  
  3095.         UL.MNU, 44
  3096.         Ungoto new messages, 21
  3097.         ungotonew, 38
  3098.  
  3099.